DXGKDDI_PROTECTED_CALLBACK função de retorno de chamada (dispmprt.h)
A rotina de retorno de chamada DxgkProtectedCallback é implementada pelo driver de miniporto de exibição e é chamada por DxgkCbExcludeAdapterAccess durante um estado protegido quando todo o acesso ao adaptador de exibição é impedido.
Sintaxe
DXGKDDI_PROTECTED_CALLBACK DxgkddiProtectedCallback;
void DxgkddiProtectedCallback(
[in] IN_CONST_PVOID MiniportDeviceContext,
[in] PVOID ProtectedCallbackContext,
[in] NTSTATUS ProtectionStatus
)
{...}
Parâmetros
[in] MiniportDeviceContext
Um identificador para um bloco de contexto associado a um adaptador de exibição. A função DxgkDdiAddDevice do driver de miniporto de exibição anteriormente forneceu esse identificador para o subsistema de kernel de elementos gráficos DirectX.
[in] ProtectedCallbackContext
Um ponteiro para informações definidas pelo driver especificadas em uma chamada anterior para DxgkCbExcludeAdapterAccess.
[in] ProtectionStatus
Status do estado protegido do adaptador de exibição. Se STATUS_SUCCESS, o adaptador foi protegido com êxito contra o acesso. Um código de status de falha indica que o adaptador não está protegido.
Valor de retorno
Nenhum
Observações
DxgkProtectedCallback deve ser chamado somente quando todo o acesso ao adaptador de exibição tiver sido interrompido, conforme indicado pelo parâmetro de status ProtectionStatus.
O driver deve garantir que as seguintes condições sejam atendidas durante a rotina de retorno de chamada:
- Todas as interrupções no dispositivo estão desabilitadas e todas as interrupções pendentes restantes são tratadas, incluindo quaisquer DPCs que possam ter sido enfileirados em qualquer CPU, mas ainda não atendidos.
- Toda a memória combinada de gravação e quaisquer outros estados relacionados ao cache foram liberados.
- Todos os eventos ACPI ou BIOS/SMI que ocorrem não acessam o hardware.
- A coerência é obtida entre todos os adaptadores em uma configuração de estado de adaptador vinculado.
- O adaptador, incluindo seus registros e modo de exibição, é mantido no estado adequado para lidar com o buffer de DMA que ocorre no retorno do rotina de DxgkProtectedCallback. O driver não deve alterar o estado visível ou os recursos de qualquer aplicativo.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dispmprt.h (inclua Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |