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 windows Display Driver Model (WDDM) 2.0 o controladores 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 de DXGKARG_POSTMULTIPLANEOVERLAYPRESENT que describe la nueva configuración de superposición confirmada recientemente.

Valor devuelto

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT devuelve los valores siguientes:

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 darán lugar a una comprobación de errores.

Comentarios

Se llama a esta función desde el nivel PASIVO.

Esta función solo se llama 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 utilizar 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 a 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 o posteriores deben administrarse mediante el controlador.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	d3dkmddi.h