estructura DXGKARG_SUBMITCOMMANDVIRTUAL (d3dkmddi.h)

Artículo
02/23/2024

DXGKARG_SUBMITCOMMANDVIRTUAL se usa para enviar un búfer de acceso directo a memoria (DMA) a un contexto que admita el direccionamiento virtual con la interfaz del controlador de dispositivo DxgkDdiSubmitCommandVirtual(DDI).

Sintaxis

typedef struct _DXGKARG_SUBMITCOMMANDVIRTUAL {
  HANDLE                         hContext;
  D3DGPU_VIRTUAL_ADDRESS         DmaBufferVirtualAddress;
  UINT                           DmaBufferSize;
  VOID                           *pDmaBufferPrivateData;
  UINT                           DmaBufferPrivateDataSize;
  UINT                           DmaBufferUmdPrivateDataSize;
  UINT                           SubmissionFenceId;
  D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  D3DDDI_FLIPINTERVAL_TYPE       FlipInterval;
  DXGK_SUBMITCOMMANDFLAGS        Flags;
  UINT                           EngineOrdinal;
  UINT                           NodeOrdinal;
} DXGKARG_SUBMITCOMMANDVIRTUAL;

Miembros

hContext

Identificador devuelto de DxgkDdiCreateContext.

DmaBufferVirtualAddress

La dirección virtual del búfer de DMA en el contexto del proceso de envío.

DmaBufferSize

Tamaño del búfer DMA en bytes.

pDmaBufferPrivateData

Puntero al búfer de datos privado del controlador.

DmaBufferPrivateDataSize

Tamaño del búfer de datos privado del controlador en bytes.

DmaBufferUmdPrivateDataSize

Tamaño de los datos del controlador privado, en bytes, que estableció el controlador en modo de usuario en SubmitCommandCb. Cuando se llama a SubmitCommandCb , el kernel de gráficos directX asigna un búfer para los datos del controlador privado con el tamaño igual a DXGK_CONTEXTINFO::DmaBufferPrivateDataSize. El controlador de modo kernel notificó este tamaño en la llamada DxgkDdiCreateContext . El kernel de gráficos de DirectX copia los datos privados del controlador de SubmitCommandCb en el búfer asignado.

SubmissionFenceId

Identificador único que el controlador puede escribir en el comando de barrera en el búfer de anillo, que es el búfer donde se ponen en cola los búferes DMA para que se ejecute la GPU. Para obtener más información sobre estos tipos de identificadores, consulte Suministro de identificadores de barrera.

VidPnSourceId

El número de identificación de base cero del origen de vídeo presente en una ruta de acceso de una topología de red presente de vídeo (VidPN) para una operación de volteo. Este miembro solo es válido cuando se establece la marca de campo de bits Flip oFlipWithNoWait en el miembro Flags .

FlipInterval

Valor de tipo D3DDDI_FLIPINTERVAL_TYPE que indica el intervalo de volteo (es decir, si el volteo se produce después de cero, uno, dos, tres o cuatro sincronizaciones verticales). FlipInterval solo es válido si se establece la marca de campo de bits Flip (es decir, TRUE) en el miembro Flags .

Flags

Estructura DXGK_SUBMITCOMMANDFLAGS que identifica información sobre el búfer DMA que se va a enviar.

EngineOrdinal

Reservado para uso futuro.

NodeOrdinal

Índice de base cero del nodo para el que se crea el contexto. Identifica el nodo cuando el contexto es NULL.