DXGKCB_MULTIPLANEOVERLAYDISABLED función de devolución de llamada (d3dkmddi.h)
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
Identificador del adaptador en el que ya no se admite la configuración de hardware mpO actual.
[in] VidPnSourceId
El VidPnSourceId en el que ya no se admite la configuración de hardware mpO actual.
Valor devuelto
Ninguno
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 puede retrasarse en varios fotogramas. Se recomienda llamar a esta función solo en casos excepcionales, como los escenarios siguientes:
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 finalmente.
MpO debe deshabilitarse debido a problemas térmicos. En este caso, el controlador no necesita deshabilitar inmediatamente MPO, pero puede esperar hasta que DWM reciba la notificación y requiera compatibilidad con MPO (que el KMD debe indicar que 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.
DXGKCB_XXX funciones se implementan mediante Dxgkrnl. Para usar esta función de devolución de llamada, llame a dxgkCbMultiPlaneOverlayDisabled a través del DXGKRNL_INTERFACE.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 1607 (WDDM 2.1) |
| de la plataforma de destino de | Windows |
| encabezado de | d3dkmddi.h |
| irQL | <= PASSIVE_LEVEL |