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 do 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 miniporta de exibição anteriormente forneceu esse identificador para o subsistema kernel de elementos gráficos do Microsoft DirectX no parâmetro de saída MiniportDeviceContext da função DxgkDdiAddDevice .
[in] pSubmitCommand
Um ponteiro para uma estrutura de DXGKARG_SUBMITCOMMAND que descreve o buffer DMA que o driver de miniporto de exibição envia para a unidade de execução de comando de hardware.
Retornar valor
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 Observações.
Comentários
Como as operações de paginação são consideradas operações do sistema, elas não estã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 membro hDevice da estrutura DXGKARG_SUBMITCOMMAND para a qual o parâmetro pSubmitCommand aponta.
No entanto, se a arquitetura de um determinado hardware e driver 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 anéis. 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 memória, o erro é observado pela mensagem BugCheck 0x119, 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 interna do agendador
DxgkDdiSubmitCommand deve se tornar inpálível porque é executado em IRQL = DISPATCH_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3dkmddi.h |
| IRQL | DISPATCH_LEVEL |