DXGKCB_ACQUIRE_POST_DISPLAY_OWNERSHIP função de retorno de chamada (dispmprt.h)
Chamado por um driver de miniportor WDDM (Modelo de Driver de Exibição do Windows) 1.2 ou posterior para obter as informações de exibição do dispositivo de exibição POST (auto-teste de ativação) atual ou do driver WDDM em execução anteriormente.
O driver deve usar essas informações de exibição para otimizar a solicitação de alteração do modo inicial depois que o dispositivo de exibição for iniciado.
Sintaxe
DXGKCB_ACQUIRE_POST_DISPLAY_OWNERSHIP DxgkcbAcquirePostDisplayOwnership;
NTSTATUS DxgkcbAcquirePostDisplayOwnership(
[in] HANDLE DeviceHandle,
[out] PDXGK_DISPLAY_INFORMATION DisplayInfo
)
{...}
Parâmetros
[in] DeviceHandle
Um identificador que representa um adaptador de exibição. O driver de miniporto de exibição obteve anteriormente esse identificador no membro DeviceHandle da estrutura DXGKRNL_INTERFACE que foi passada para DxgkDdiStartDevice.
[out] DisplayInfo
Um ponteiro para uma estrutura DXGK_DISPLAY_INFORMATION alocada pelo driver de miniporto de exibição. Se DxgkCbAcquirePostDisplayOwnership retornar STATUS_SUCCESS, essa estrutura conterá informações de exibição para o dispositivo de exibição atual usado para operações POST.
Retornar valor
DxgkCbAcquirePostDisplayOwnership retornará STATUS_SUCCESS se for bem-sucedido. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.
Comentários
Formatos de cor permitidos
O membro DisplayInfo->ColorFormat deve incluir uma combinação bit a bit-OR dos dois formatos a seguir:- D3DDDIFMT_X8R8G8B8
- D3DDDIFMT_A8R8G8B8
Inicialização de destino de apresentação de vídeo
É possível que o membro DisplayInfo->TargetId não seja inicializado. Nesse caso, o identificador do destino presente do vídeo é D3DDDI_ID_UNINITIALIZED. Normalmente, isso ocorre após uma inicialização do sistema.Da mesma forma, é possível que o membro DisplayInfo-AcpiId> não seja inicializado. Nesse caso, o AcpiId do identificador ACPI tem um valor igual a zero.
No caso de uma atualização de driver para driver, o driver anterior fornecerá o identificador de destino e o identificador ACPI.
Diretrizes de implementação
A partir do WDDM 1.2, o driver de miniporto de exibição deve seguir estas diretrizes quando chamar DxgkCbAcquirePostDisplayOwnership:- O ponto de entrada para a função DxgkCbAcquirePostDisplayOwnership faz parte da estrutura DXGKRNL_INTERFACE . Essa estrutura é retornada ao driver por meio do parâmetro DxgkInterface quando a função DxgkDdiStartDevice do driver é chamada.
- É opcional que o driver de miniporte de exibição chame DxgkCbAcquirePostDisplayOwnership. No entanto, o sistema operacional ainda poderá chamar a função DxgkDdiStopDeviceAndReleasePostDisplayOwnership do driver do dispositivo se o driver não chamou anteriormente DxgkCbAcquirePostDisplayOwnership.
- O driver de miniporto de exibição poderá chamar DxgkCbAcquirePostDisplayOwnership se o dispositivo for iniciado em resposta a um evento de Plug and Play (PnP). Nesse caso, o driver deve chamar DxgkCbAcquirePostDisplayOwnership de dentro do contexto da chamada para a função DxgkDdiStartDevice .
- O driver de miniporto de exibição poderá chamar DxgkCbAcquirePostDisplayOwnership se o dispositivo retomar um estado de energia PowerDeviceD0 após um estado de hibernação. Nesse caso, o driver deve chamar DxgkCbAcquirePostDisplayOwnership de dentro do contexto da chamada para a função DxgkDdiSetPowerState .
-
O driver de miniporto de exibição só deve chamar a função DxgkCbAcquirePostDisplayOwnership se o driver estiver em execução em Windows 8 ou uma versão posterior do sistema operacional Windows.
Nota O driver de miniporto de exibição pode chamar RtlGetVersion para determinar a versão do sistema operacional.
- DxgkCbAcquirePostDisplayOwnership pode retornar uma estrutura DXGK_DISPLAY_INFORMATION com o membro Width definido como zero. Isso indica que o dispositivo de exibição atual não é capaz de operações POST ou o sistema operacional não tem as informações de exibição atuais para o dispositivo POST atual.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 |
| Servidor mínimo com suporte | Windows Server 2012 |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | dispmprt.h (inclua Dispmprt.h) |
| IRQL | <= APC_LEVEL |