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

Artículo
02/25/2024

Un controlador de minipuerto de pantalla llama a DXGKCB_SETPOWERCOMPONENTACTIVE para acceder a un componente de energía. Una vez que se devuelve esta función, el controlador de minipuerto de pantalla puede cambiar la configuración de hardware del componente.

Sintaxis

DXGKCB_SETPOWERCOMPONENTACTIVE DxgkcbSetpowercomponentactive;

void DxgkcbSetpowercomponentactive(
  [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

Cada llamada a esta función debe emparejarse con una llamada a la función DXGKCB_SETPOWERCOMPONENTIDLE para indicar que el hardware del componente ya no es necesario.

Cuando se llama a esta función, el recuento de referencias activo del componente aumenta en 1. Power Management Framework mantiene el recuento de referencias y coloca el componente en un estado F inferior solo cuando el recuento de referencias se convierte en cero.

Al llamar a esta función, el controlador de minipuerto de pantalla puede recibir una llamada a la función DxgkDdiSetPowerComponentFState en otro subproceso de ejecución.

DXGKCB_XXX funciones se implementan mediante Dxgkrnl. Para usar esta función de devolución de llamada, llame a DxgkCbSetPowerComponentActive 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	PASSIVE_LEVEL