Compartilhar via


DXGKDDI_SUBMITCOMMANDVIRTUAL função de retorno de chamada (d3dkmddi.h)

O comando DxgkDdiSubmitCommandVirtual envia um buffer DMA para um contexto que dá suporte ao endereçamento virtual.

Sintaxe

DXGKDDI_SUBMITCOMMANDVIRTUAL DxgkddiSubmitcommandvirtual;

NTSTATUS DxgkddiSubmitcommandvirtual(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_SUBMITCOMMANDVIRTUAL pSubmitCommand
)
{...}

Parâmetros

hAdapter

Um identificador para um bloco de contexto associado a um adaptador de exibição. O KMD (driver de miniport de exibição) forneceu anteriormente esse identificador para Dxgkrnl no parâmetro de saída MiniportDeviceContext da função DxgkDdiAddDevice .

pSubmitCommand

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

Valor de retorno

Valor descrição
STATUS_SUCCESS O comando enviado é bem formado.
STATUS_INVALID_PARAMETER O DMA ou os dados privados são determinados como malformados. Nesse caso, o sistema operacional colocará o dispositivo de chamada em um estado de erro e todas as chamadas subsequentes nele falharão. O valor SubmissionFenceId passado para essa chamada será considerado concluído após a conclusão de todos os pacotes anteriores no hardware e, nesse ponto, a noção de driver da última ID de cerca concluída deve ser atualizada para esse valor. Esse comportamento é diferente de uma chamada paraDxgkDdiSubmitCommand, em que nenhum erro pode ser retornado devido à capacidade de validar os dados em uma chamada DxgkDdiRender anterior.

Todos os outros valores retornados levarão a uma verificação de bugs do sistema operacional.

Observações

DxgkDdiSubmitCommandVirtual funciona com endereçamento de memória virtual, enquanto DxgkDdiSubmitCommand é chamado com memória física. DxgkDdiSubmitCommandVirtual permite que o driver gerencie a memória com mais flexibilidade.

A GPU pode ter trabalhado anteriormente com um espaço de endereço diferente, talvez para outro processo ou contexto. O driver é responsável por garantir que o espaço de endereço correto seja restaurado antes de enviar um buffer de DMA específico.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 10
servidor com suporte mínimo Windows Server 2016
da Plataforma de Destino Área de trabalho
cabeçalho d3dkmddi.h

Consulte também

DXGKARG_SUBMITCOMMANDVIRTUAL

DxgkDdiRender

DxgkDdiSubmitCommand