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 |