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

DXGKCB_COMPLETEFSTATETRANSITION notifica al controlador de puerto que un componente de energía ha completado la transición de estado F.

Sintaxis

DXGKCB_COMPLETEFSTATETRANSITION DxgkcbCompletefstatetransition;

void DxgkcbCompletefstatetransition(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex
)
{...}

Parámetros

[in] hAdapter

Identificador del adaptador de pantalla. El controlador de miniporte de pantalla recibe el identificador del miembro DeviceHandle de la estructura DXGKRNL_INTERFACE en una llamada a su función DxgkDdiStartDevice.

[in] ComponentIndex

Índice del componente de energía especificado por DXGKARG_QUERYADAPTERINFO. pInputData en una llamada a la función DxgkDdiQueryAdapterInfo.

Valor devuelto

Ninguno

Observaciones

Durante el registro de componentes, el controlador de miniporte de pantalla debe indicar todos los componentes de energía para los que tendrá que llamar a la función DXGKCB_COMPLETEFSTATETRANSITION estableciendo el DXGK_POWER_COMPONENT_FLAGS.miembro driverCompletesFStateTransition a 1. Cuando se establece este miembro, el controlador debe llamar a esta función de forma sincrónica o asincrónica. Por el contrario, si no se establece este miembro, el controlador no debe llamar a esta función.

Nota

Si DXGK_POWER_COMPONENT_FLAGS.se ha establecido el DriverCompletesFStateTransition, pero el controlador no llama a esta función, pueden producirse interbloqueos.

El marco de administración de energía de Windows garantiza que no se enviará ninguna nueva solicitud de transición para el componente hasta que se llame a esta función.

Normalmente, el controlador de puerto espera que cuando se devuelva esta función, se completa la transición de estado F. Podría haber escenarios en los que el controlador de miniporte de pantalla no puede completar la transición sincrónicamente, por ejemplo, si el controlador de miniporte de pantalla no puede completar las transiciones en DISPATCH_LEVEL, o si necesita activar otros componentes de energía. Esta función ayuda al controlador de miniporte de pantalla a completar la transición de estado F de forma asincrónica.

DXGKCB_XXX funciones se implementan mediante Dxgkrnl. Para usar esta función de devolución de llamada, establezca los miembros de DXGKARGCB_ALLOCATEPAGESFORMDL y llame a DxgkCbCompleteFStateTransition a través del DXGKRNL_INTERFACE.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 8 (WDDM 1.2)
servidor mínimo admitido	Windows Server 2012
de la plataforma de destino de	Escritorio
encabezado de	d3dkmddi.h (incluya D3dkmddi.h)
irQL	<=DISPATCH_LEVEL

Consulte también

DXGK_POWER_COMPONENT_FLAGS

DXGKRNL_INTERFACE