Compartilhar via

DXGKCB_MULTIPLANEOVERLAYDISABLED função de retorno de chamada (d3dkmddi.h)

  • Artigo

Um driver de miniporta de exibição no modo kernel chama DXGKCB_MULTIPLANEOVERLAYDISABLED para indicar que a configuração de MPO (sobreposição multiplano) atual não tem mais suporte no VidPnSourceId especificado.

Sintaxe

DXGKCB_MULTIPLANEOVERLAYDISABLED DxgkcbMultiplaneoverlaydisabled;

void DxgkcbMultiplaneoverlaydisabled(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT VidPnSourceId
)
{...}

Parâmetros

[in] hAdapter

Manipule para o adaptador no qual não há mais suporte para a configuração de hardware do MPO atual.

[in] VidPnSourceId

O VidPnSourceId no qual a configuração de hardware atual do MPO não tem mais suporte.

Retornar valor

Nenhum

Comentários

DXGKCB_MULTIPLANEOVERLAYDISABLED notifica o DWM (Gerenciador de Área de Trabalho do Windows) de que a configuração atual do MPO não tem mais suporte, permitindo que o DWM volte à composição.

Essa solicitação é processada de forma assíncrona e pode ser atrasada por vários quadros. É recomendável chamar essa função apenas em casos excepcionais, como os seguintes cenários:

  • Um evento de alteração de exibição ou hot plug em uma saída torna não mais possível continuar dando suporte a uma configuração de MPO confirmada em um monitor diferente. Nesse caso, o driver pode desabilitar os planos de sobreposição no monitor. O usuário verá um artefato visível, mas ele deverá ser corrigido eventualmente pelo DWM.

  • O MPO deve ser desabilitado devido a problemas térmicos. Nesse caso, o driver não precisa desabilitar imediatamente o MPO, mas pode aguardar até que o DWM receba a notificação e exija suporte ao MPO (o que o KMD deve indicar que não tem suporte devido ao problema térmico). Nesse momento, o DWM desabilitará o MPO e começará a redigir.

Para casos típicos, os drivers devem impedir configurações de sobreposição multiplano incompatíveis respondendo corretamente a DxgkDdiCheckMultiplaneOverlaySupport3.

DXGKCB_XXX funções são implementadas por Dxgkrnl. Para usar essa função de retorno de chamada, chame DxgkCbMultiPlaneOverlayDisabled por meio do DXGKRNL_INTERFACE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1607 (WDDM 2.1)
Plataforma de Destino Windows
Cabeçalho d3dkmddi.h
IRQL <= PASSIVE_LEVEL

Confira também

DxgkDdiCheckMultiplaneOverlaySupport3

DXGKRNL_INTERFACE