Compartilhar via


Função D3DKMTSubmitCommand (d3dkmthk.h)

D3DKMTSubmitCommand é usado para enviar buffers de comando em contextos que dão suporte ao endereçamento virtual de GPU (unidade de processamento gráfico). Esses contextos geram comandos diretamente do modo de usuário, gerenciam seu próprio pool de buffers de comandos e não usam a lista de alocação ou localização de patch.

Sintaxe

NTSTATUS D3DKMTSubmitCommand(
  [in] const D3DKMT_SUBMITCOMMAND *unnamedParam1
);

Parâmetros

[in] unnamedParam1

Um ponteiro para uma estrutura D3DKMT_SUBMITCOMMAND que descreve a operação.

Retornar valor

Código de retorno Descrição
STATUS_SUCCESS O contexto do dispositivo foi criado com êxito.
STATUS_INVALID_PARAMETER Os parâmetros foram validados e determinados como incorretos.

Essa função também pode retornar outros valores NTSTATUS .

Comentários

Essa função substitui a função Render antiga para esses contextos e deve ser usada em seu lugar. Os contextos que operam no modo de patch herdado devem continuar a usar a função Render antiga .

Embora o driver de modo de usuário não gere locais de patch, ele ainda deve gerar uma lista de primárias, que estão sendo gravadas. O gerenciador de memória de vídeo usa a lista de alocação para determinar quais alocações primárias estão sendo referenciadas para gravação por cada buffer de comando. Essas informações são usadas para sincronizar a renderização com as primárias com operações de inversão .

Alguns drivers de modo kernel precisam de informações de seu driver de modo de usuário sobre como enviar um buffer de DMA (acesso direto à memória) específico para sua GPU. No Modelo de Driver de Exibição do Windows (WDDM) 1.0, essas informações foram enviadas pelo driver de modo de usuário para o driver do modo kernel por meio do buffer de comando. Como o buffer de DMA é criado diretamente pelo driver de modo de usuário e enviado para a GPU sem modificação, ele não pode mais ser usado para enviar informações ao driver de kernel. Para habilitar a transferência de informações entre o modo de usuário e os drivers do modo kernel, um buffer de dados de driver privado explícito foi adicionado para ser enviado junto com um envio.

Observação

Esses dados de driver privado são unidirecionais e o driver do modo kernel não pode retornar informações para o driver de modo de usuário por meio desse buffer.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Universal
Cabeçalho d3dkmthk.h (inclua D3dkmthk.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

D3DKMT_SUBMITCOMMAND