Função D3DKMTSubmitCommand (d3dkmthk.h)
D3DKMTSubmitCommand é usado para enviar buffers de comando em contextos que dão suporte ao endereçamento virtual da 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 fazem uso da lista de localização de patch ou alocação.
Sintaxe
NTSTATUS D3DKMTSubmitCommand(
[in] const D3DKMT_SUBMITCOMMAND *unnamedParam1
);
Parâmetros
[in] unnamedParam1
Um ponteiro para uma estrutura de D3DKMT_SUBMITCOMMAND que descreve a operação.
Valor de retorno
| 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 de NTSTATUS.
Observações
Essa função substitui a antiga função Renderizar 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 de renderização de 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 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 do 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.
Nota
Esses dados de driver privado são unidirecionais e o driver do modo kernel não pode retornar informações ao driver do modo de usuário por meio desse buffer.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10 |
| servidor com suporte mínimo | Windows Server 2016 |
| da Plataforma de Destino | Universal |
| cabeçalho | d3dkmthk.h (inclua D3dkmthk.h) |
| biblioteca | Gdi32.lib |
| de DLL | Gdi32.dll |