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

Se llama después de que se aplique una nueva configuración de superposición de varios planos, lo que permite al controlador optimizar el estado de hardware. Opcional para controladores de windows Display Driver Model (WDDM) 2.0 o posteriores que admiten superposiciones de varios planos.

Sintaxis

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT DxgkddiPostmultiplaneoverlaypresent;

NTSTATUS DxgkddiPostmultiplaneoverlaypresent(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_POSTMULTIPLANEOVERLAYPRESENT pPostPresent
)
{...}

Parámetros

hAdapter

Identifica el adaptador que contiene el hardware de superposición.

pPostPresent

Puntero a una estructura DXGKARG_POSTMULTIPLANEOVERLAYPRESENT que describe la nueva configuración de superposición confirmada recientemente.

Valor devuelto

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT devuelve los siguientes valores:

Código devuelto	Descripción
STATUS_SUCCESS	Si la rutina se ha completado correctamente. El controlador siempre debe devolver un código correcto. Los errores producirán una comprobación de errores.

Observaciones

Esta función se llama desde el nivel PASIVO.

Solo se llama a esta función cuando el controlador establece PostPresentNeeded de DXGKCB_NOTIFY_MPO_VSYNC_FLAGS miembro de la estructura DXGKARGCB_NOTIFY_INTERRUPT_DATA en la devolución de llamada VSYNC.

El controlador puede usar esta función para reducir los niveles de voltaje, los relojes, las profundidades FIFO o cualquier otra optimización que pueda ahorrar energía.

El controlador no debe dedicar mucho tiempo en esta llamada, ya que la llamada bloquea el subproceso principal del programador de GPU y el retraso podrían provocar problemas. Las acciones que consumen mucho tiempo se deben poner en cola como elementos de trabajo independientes por controlador y controlarse en segundo plano. En este escenario, los conflictos entre el elemento en cola y los cambios de hardware solicitados por futuras llamadas previas y posteriores deben administrarse mediante el controlador.

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	d3dkmddi.h