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 miniporta de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos DirectX.

[in] ProtectedCallbackContext

Um ponteiro para informações definidas pelo driver que foi especificada em uma chamada anterior para DxgkCbExcludeAdapterAccess.

[in] ProtectionStatus

Status do estado protegido do adaptador de vídeo. Se STATUS_SUCCESS, o adaptador foi protegido com êxito contra o acesso. Uma falha status código indica que o adaptador não está protegido.

Retornar valor

Nenhum

Comentários

DxgkProtectedCallback deve ser chamado somente quando todo o acesso ao adaptador de exibição tiver sido interrompido, conforme indicado pelo parâmetro 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 enfileiradas em qualquer CPU, mas ainda não atendidas.
• Toda a memória combinada de gravação e quaisquer outros estados relacionados ao cache foram liberados.
• 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 do adaptador vinculado.
• O adaptador, incluindo seus registros e modo de exibição, é mantido no estado adequado para manipular o buffer de DMA que ocorre no retorno da rotina DxgkProtectedCallback . O driver não deve alterar o estado visível ou as funcionalidades de nenhum aplicativo.

Requisitos

Confira também

DxgkCbExcludeAdapterAccess