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 minipuerto 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

None

Observaciones

Durante el registro de componentes, el controlador de minipuerto 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. DriverCompletesFStateTransition se ha establecido, 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 esta función vuelva, se completa la transición de estado F. Podría haber escenarios en los que el controlador de minipuerto de pantalla no puede completar la transición sincrónicamente, por ejemplo, si el controlador de minipuerto 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 minipuerto 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, a continuación, llame a DxgkCbCompleteFStateTransition a través del DXGKRNL_INTERFACE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 (WDDM 1.2)
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Escritorio
Encabezado	d3dkmddi.h (incluya D3dkmddi.h)
IRQL	<=DISPATCH_LEVEL

Consulte también

DXGK_POWER_COMPONENT_FLAGS

DXGKRNL_INTERFACE