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

DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 se llama a para cambiar la configuración de superposición que se muestra.

Sintaxis

DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3;

NTSTATUS DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3(
  IN_CONST_HANDLE hAdapter,
  IN_OUT_PDXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 pSetVidPnSourceAddressWithMultiPlaneOverlay
)
{...}

Parámetros

hAdapter

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

pSetVidPnSourceAddressWithMultiPlaneOverlay

Puntero a una estructura DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 que describe las superficies y las opciones de visualización que se van a presentar.

Valor devuelto

DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 devuelve los valores siguientes:

Código devuelto	Descripción
STATUS_SUCCESS	La rutina se completó correctamente.
STATUS_INVALID_PARAMETER	En el [modelo de cola de volteo de hardware]/windows-hardware/drivers/display/hardware-flip-queue), el controlador no pudo procesar una solicitud de volteo.
STATUS_RETRY	Se devuelve por motivos como que el controlador no pudo poner en cola una solicitud al hardware debido a volteos pendientes o es necesario llamar al controlador en el PASSIVE_LEVEL. Si es necesario llamar al controlador en PASSIVE_LEVEL también debe establecer el DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS. Marca PrePresentNeeded .

Comentarios

Normalmente se llama a esta función en el nivel de interrupción, pero si el controlador necesita realizar la configuración de hardware que solo se puede realizar en PASSIVE_LEVEL, el controlador puede solicitar que esta función se recupere en PASSIVE_LEVEL devolviendo STATUS_RETRY y estableciendo el DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS. Marca PrePresentNeeded .

Incluso cuando se llama en PASSIVE_LEVEL, el controlador debe evitar gastar una cantidad significativa de tiempo en esta llamada porque 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, el controlador debe administrar los conflictos entre el elemento en cola y los cambios de hardware solicitados por futuras llamadas previas o posteriores.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	d3dkmddi.h

Consulte también

DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3