estructura D3DDDICB_SUBMITCOMMAND (d3dumddi.h)

Artículo
02/06/2025

La estructura D3DDDICB_SUBMITCOMMAND se usa para enviar búferes de comandos en contextos que admiten direccionamiento virtual de unidad de procesamiento gráfico (GPU).

Sintaxis

typedef struct _D3DDDICB_SUBMITCOMMAND {
  D3DGPU_VIRTUAL_ADDRESS      Commands;
  UINT                        CommandLength;
  D3DDDICB_SUBMITCOMMANDFLAGS Flags;
  UINT                        BroadcastContextCount;
  HANDLE                      BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
  VOID                        *pPrivateDriverData;
  UINT                        PrivateDriverDataSize;
  UINT                        NumPrimaries;
  D3DKMT_HANDLE               WrittenPrimaries[D3DDDI_MAX_WRITTEN_PRIMARIES];
  D3DDDI_MARKERLOGTYPE        MarkerLogType;
  UINT                        RenderCBSequence;
  union {
    struct {
      UINT FirstAPISequenceNumberHigh;
      UINT CompletedAPISequenceNumberLow0Size;
      UINT CompletedAPISequenceNumberLow1Size;
      UINT BegunAPISequenceNumberLow0Size;
      UINT BegunAPISequenceNumberLow1Size;
    };
    UINT BatchedMarkerDataCount;
  };
  union {
    struct {
      const UINT *pCompletedAPISequenceNumberLow0;
      const UINT *pCompletedAPISequenceNumberLow1;
      const UINT *pBegunAPISequenceNumberLow0;
      const UINT *pBegunAPISequenceNumberLow1;
    };
    const D3DDDI_BATCHEDMARKERDATA *pBatchedMarkerData;
  };
  UINT                        Reserved;
  UINT                        NumHistoryBuffers;
  D3DKMT_HANDLE               *HistoryBufferArray;
  HANDLE                      hSyncToken;
  void                        *pReserved;
} D3DDDICB_SUBMITCOMMAND;

Miembros

Commands

Dirección virtual de GPU a los comandos que se envían al contexto para su ejecución. Esta información se proporciona al controlador del modo kernel durante el envío del comando y también se usa con fines de depuración.

CommandLength

Especifica la longitud, en bytes, de los comandos que se envían a la GPU. Esta información se proporciona al controlador del modo kernel durante el envío del comando y también se usa con fines de depuración.

Flags

Instancia de la estructura D3DDDICB_SUBMITCOMMANDFLAGS.

BroadcastContextCount

Especifica el número de contexto al que se debe enviar este comando. Este recuento debe ser al menos 1.

BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

Especifica el identificador del contexto para ejecutar los comandos especificados.

pPrivateDriverData

Puntero a los datos privados del controlador que se van a pasar al controlador del modo kernel como parte de este envío.

PrivateDriverDataSize

Tamaño de la información de datos del controlador privado que se pasa. Este tamaño debe ser menor que el tamaño solicitado por el controlador de modo kernel para enviar datos del controlador privado.

NumPrimaries

Especifica el número de búferes principales y back-chain de intercambio escritos en los comandos enviados. Esto es igual al número de asignaciones de la matriz WrittenPrimaries.

WrittenPrimaries[D3DDDI_MAX_WRITTEN_PRIMARIES]

Matrices de identificadores de los búferes principales y de la cadena de intercambio que escriben los comandos enviados.

MarkerLogType

Enumeración D3DDDI_MARKERLOGTYPE que indica el tipo de marcador en el registro seguimiento de eventos para Windows (ETW) que admite el controlador de visualización en modo de usuario.

RenderCBSequence

Identificador único para cada llamada de función pfnRenderCb. Comienza en un valor de 1 para los contextos asociados a DDIs y intervalos en modo de usuario de un solo subproceso a un valor de 0x80000001 para contextos asociados a DDIs de modo de usuario sin subprocesos. El controlador de pantalla en modo de usuario debe incrementar el valor de cada pfnRenderCb llamada que realiza en cualquier motor.

FirstAPISequenceNumberHigh