struttura DXGKARG_SUBMITCOMMANDVIRTUAL (d3dkmddi.h)

Articolo
08/07/2023

DXGKARG_SUBMITCOMMANDVIRTUAL viene usato per inviare un buffer DMA (Direct Memory Access) a un contesto che supporta l'indirizzamento virtuale con DxgkDdiSubmitCommandVirtualDevice Driver Interface (DDI).

Sintassi

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;

Members

hContext

Handle restituito da DxgkDdiCreateContext.

DmaBufferVirtualAddress

Indirizzo virtuale per il buffer DMA nel contesto del processo di invio.

DmaBufferSize

Dimensioni del buffer DMA in byte.

pDmaBufferPrivateData

Puntatore al buffer di dati privato del driver.

DmaBufferPrivateDataSize

Dimensioni del buffer di dati privato del driver in byte.

DmaBufferUmdPrivateDataSize

Dimensioni dei dati del driver privato, in byte, impostati dal driver in modalità utente in SubmitCommandCb. Quando viene chiamato SubmitCommandCb , il kernel grafico DirectX alloca un buffer per i dati del driver privato con dimensioni uguali a DXGK_CONTEXTINFO::DmaBufferPrivateDataSize. Questa dimensione è stata segnalata dal driver in modalità kernel nella chiamata DxgkDdiCreateContext . Il kernel grafico DirectX copia i dati privati del driver da SubmitCommandCb al buffer allocato.

SubmissionFenceId

Identificatore univoco che il driver può scrivere nel comando di isolamento nel buffer circolare, ovvero il buffer in cui i buffer DMA vengono accodati per l'esecuzione della GPU. Per altre informazioni su questi tipi di identificatori, vedere Fornitura di identificatori di isolamento.

VidPnSourceId

Numero di identificazione in base zero del video presente nell'origine in un percorso di una topologia di rete presente video (VidPN) per un'operazione di inversione. Questo membro è valido solo quando il flag di campo di bit Flip o FlipWithNoWait è impostato nel membro Flags .

FlipInterval

Valore tipizzato D3DDDI_FLIPINTERVAL_TYPE che indica l'intervallo di capovolgimento, ovvero se l'inversione si verifica dopo zero, uno, due, tre o quattro sincronizzazioni verticali. FlipInterval è valido solo se il flag di campo di bit Flip è impostato (vale a dire TRUE) nel membro Flags .

Flags

Struttura DXGK_SUBMITCOMMANDFLAGS che identifica le informazioni sul buffer DMA da inviare.

EngineOrdinal

Riservato per utilizzi futuri.

NodeOrdinal

Indice in base zero del nodo per cui viene creato il contesto. Identifica il nodo quando il contesto è NULL.