DXGKDDI_SUBMITCOMMAND função de retorno de chamada (d3dkmddi.h)
A função DxgkDdiSubmitCommand envia um buffer de DMA (acesso direto à memória) para a unidade de execução de comando de hardware.
Sintaxe
DXGKDDI_SUBMITCOMMAND DxgkddiSubmitcommand;
NTSTATUS DxgkddiSubmitcommand(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_SUBMITCOMMAND pSubmitCommand
)
{...}
Parâmetros
[in] hAdapter
Um identificador para um bloco de contexto associado a um adaptador de exibição. O driver de miniporto de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos do Microsoft DirectX na função MiniportDeviceContext da função deDxgkDdiAddDevice.
[in] pSubmitCommand
Um ponteiro para uma estrutura de DXGKARG_SUBMITCOMMAND que descreve o buffer de DMA que o driver de miniporto de exibição envia para a unidade de execução de comando de hardware.
Valor de retorno
DxgkDdiSubmitCommand retorna STATUS_SUCCESS após a conclusão bem-sucedida. Se o driver retornar um código de erro, o sistema operacional fará com que ocorra uma verificação de bugs do sistema. Consulte Comentários.
Observações
Como as operações de paginação são consideradas operações do sistema, elas não são associadas a um contexto de aplicativo específico ou contexto gráfico. Portanto, quando o envio é para uma operação de paginação, a função DxgkDdiSubmitCommand é chamada com NULL especificado no hDevice membro da estrutura DXGKARG_SUBMITCOMMAND à qual o parâmetro pSubmitCommand aponta.
No entanto, se a arquitetura de um hardware e driver específicos precisar ter um dispositivo internamente, o driver deverá criar internamente o dispositivo durante a inicialização do adaptador e deve manter o dispositivo internamente como o dispositivo padrão do sistema para uso em operações de paginação.
O driver pode gravar o valor fornecido no membro SubmissionFenceId de DXGKARG_SUBMITCOMMAND no comando fence no buffer de anel. Para obter mais informações sobre comandos de cerca, consulte Fornecendo identificadores de cerca.
Se o driver retornar um código de erro, o subsistema de kernel de elementos gráficos DirectX fará com que ocorra uma verificação de bugs do sistema. Em um arquivo de despejo de falha, o erro é observado pela mensagem 0x119BugCheck, que terá os quatro parâmetros a seguir.
- 0x2 (identifica a causa do erro)
- O código de erro NTSTATUS retornado da chamada de driver com falha
- Um ponteiro para a estrutura DXGKARG_SUBMITCOMMAND
- Um ponteiro para uma estrutura de dados do agendador interno
DxgkDdiSubmitCommand deve ser inpálida porque é executada em IRQL = DISPATCH_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h |
| IRQL | DISPATCH_LEVEL |