estrutura DXGKARG_SUBMITCOMMANDVIRTUAL (d3dkmddi.h)

Artigo
08/07/2023

DXGKARG_SUBMITCOMMANDVIRTUAL é usado para enviar um buffer de DMA (acesso direto à memória) para um contexto que dá suporte ao endereçamento virtual com a DDI (interface do driver de dispositivo ) DxgkDdiSubmitCommandVirtual.

Sintaxe

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;

Membros

hContext

O identificador retornado de DxgkDdiCreateContext.

DmaBufferVirtualAddress

O endereço virtual do buffer de DMA no contexto do processo de envio.

DmaBufferSize

O tamanho do buffer de DMA em bytes.

pDmaBufferPrivateData

Um ponteiro para o buffer de dados privado do driver.

DmaBufferPrivateDataSize

O tamanho do buffer de dados privados do driver em bytes.

DmaBufferUmdPrivateDataSize

Tamanho dos dados do driver privado, em bytes, que foram definidos pelo driver de modo de usuário em SubmitCommandCb. Quando SubmitCommandCb é chamado, o kernel de elementos gráficos DirectX aloca um buffer para os dados do driver privado com o tamanho igual a DXGK_CONTEXTINFO::DmaBufferPrivateDataSize. Esse tamanho foi relatado pelo driver do modo kernel na chamada DxgkDdiCreateContext . O kernel de elementos gráficos DirectX copia os dados privados do driver do SubmitCommandCb para o buffer alocado.

SubmissionFenceId

Um identificador exclusivo que o driver pode gravar no comando fence no buffer de anéis, que é o buffer em que os buffers DMA são enfileirados para que a GPU seja executada. Para obter mais informações sobre esses tipos de identificadores, consulte Fornecendo identificadores de cerca.

VidPnSourceId

O número de identificação baseado em zero da origem do vídeo presente em um caminho de uma topologia VidPN (rede presente em vídeo) para uma operação de inversão. Esse membro é válido somente quando o sinalizador de campo de bits Flip ou FlipWithNoWait é definido no membro Flags .

FlipInterval

Um valor de tipo D3DDDI_FLIPINTERVAL_TYPE que indica o intervalo de inversão (ou seja, se a inversão ocorrer após zero, uma, duas, três ou quatro sincronizações verticais). FlipInterval só será válido se o sinalizador de campo de bits Flip estiver definido (ou seja, TRUE) no membro Flags .

Flags

Uma estrutura DXGK_SUBMITCOMMANDFLAGS que identifica informações sobre o buffer de DMA a ser enviada.

EngineOrdinal

Reservado para uso futuro.

NodeOrdinal

O índice baseado em zero do nó para o qual o contexto é criado. Identifica o nó quando o contexto é NULL.