DXGKDDI_PRESENTDISPLAYONLY função de retorno de chamada (d3dkmddi.h)
Apresenta a imagem de tela para o dispositivo de exibição de um KMDOD (driver somente exibição no modo kernel).
Sintaxe
DXGKDDI_PRESENTDISPLAYONLY DxgkddiPresentdisplayonly;
NTSTATUS DxgkddiPresentdisplayonly(
IN_CONST_HANDLE hAdapter,
IN_CONST_PDXGKARG_PRESENT_DISPLAYONLY pPresentDisplayOnly
)
{...}
Parâmetros
hAdapter
Um identificador para o contexto do dispositivo para o adaptador de exibição. A função DxgkDdiAddDevice do KMDOD retornou anteriormente esse identificador no parâmetro MiniportDeviceContext.
pPresentDisplayOnly
Um ponteiro para uma estrutura de DXGKARG_PRESENT_DISPLAYONLY que contém informações sobre a operação atual.
Valor de retorno
Retorna um dos seguintes valores:
| Código de retorno | descrição |
|---|---|
| STATUS_SUCCESS | A operação atual foi concluída com êxito. |
| STATUS_PENDING | A operação atual foi enviada para a fila de software ou hardware a ser concluída. Nesse caso, o KMDOD deve usar uma DPC (chamada de procedimento de interrupção e adiada) para relatar o progresso da operação atual. Caso contrário, o sistema operacional usa o processo de TDR (Detecção e Recuperação de Tempo Limite), que relata um erro e exige que o KMDOD se reinicialize e redefina a GPU. Observe que esse código de status não deve ser retornado para o modo síncrono, conforme descrito em Comentários. |
O driver também pode retornar qualquer outro código de status de erro definido em Ntstatus.h para indicar problemas que ocorreram com a operação atual.
Observações
O KMDOD deve concluir todos os movimentos tela a tela antes de copiar retângulos sujos. Além disso, o KMDOD deve concluir cada operação de movimentação/cópia antes de iniciar outra operação de movimentação/cópia.
O sistema operacional dá suporte a dois modos de operações PRESENTES KMDOD: síncrono e assíncrono. Dependendo da implementação de hardware e driver, o KMDOD pode usar o modo ou alternar entre eles a qualquer momento.
O sistema operacional garante que essa função siga o modo de sincronização de nível zero, conforme definido em de Nível Zero de Threading e Sincronização.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 8 |
| servidor com suporte mínimo | Windows Server 2012 |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |
Consulte também
DXGKARGCB_NOTIFY_INTERRUPT_DATA