DXGKCB_MULTIPLANEOVERLAYDISABLED función de devolución de llamada (d3dkmddi.h)

  • Artículo

Un controlador de miniporte de pantalla en modo kernel llama a DXGKCB_MULTIPLANEOVERLAYDISABLED para indicar que la configuración actual de superposición de varios planos (MPO) ya no se admite en el VidPnSourceId especificado.

Sintaxis

DXGKCB_MULTIPLANEOVERLAYDISABLED DxgkcbMultiplaneoverlaydisabled;

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

Parámetros

[in] hAdapter

Control para el adaptador en el que ya no se admite la configuración de hardware mpO actual.

[in] VidPnSourceId

VidPnSourceId en el que ya no se admite la configuración de hardware mpO actual.

Valor devuelto

None

Observaciones

DXGKCB_MULTIPLANEOVERLAYDISABLED notifica al Administrador de Windows de escritorio (DWM) que la configuración de MPO actual ya no se admite, lo que permite que DWM vuelva a la composición.

Esta solicitud se procesa de forma asincrónica y se puede retrasar en varios fotogramas. Se recomienda llamar a esta función solo en casos excepcionales, como los siguientes escenarios:

  • Un cambio de pantalla o un evento de conexión activa en una salida hace que ya no sea posible seguir admitiendo una configuración de MPO que se confirma en un monitor diferente. En este caso, el controlador puede deshabilitar los planos de superposición en el monitor. El usuario verá un artefacto visible, pero el DWM debería corregirlo.

  • MpO debe deshabilitarse debido a problemas térmicos. En este caso, el controlador no necesita deshabilitar mpO inmediatamente, pero puede esperar hasta que DWM reciba la notificación y requiera compatibilidad con MPO (que el KMD debe indicar no se admite debido al problema térmico). En ese momento, DWM deshabilitará MPO e iniciará la redacción.

En los casos típicos, los controladores deben evitar configuraciones de superposición multiplano incompatibles respondiendo correctamente a DxgkDdiCheckMultiplaneOverlaySupport3.

Dxgkrnl implementa DXGKCB_XXX funciones. Para usar esta función de devolución de llamada, llame a DxgkCbMultiPlaneOverlayDisabled a través del DXGKRNL_INTERFACE.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1607 (WDDM 2.1)
Plataforma de destino Windows
Encabezado d3dkmddi.h
IRQL <= PASSIVE_LEVEL

Consulte también

DxgkDdiCheckMultiplaneOverlaySupport3

DXGKRNL_INTERFACE