Función de devolución de llamada DXGKDDISETPOWERCOMPONENTFSTATE (d3dkmddi.h)

Artículo
02/23/2024

Llamado por el subsistema del kernel de gráficos de Microsoft DirectX para realizar la transición de un componente de energía a un estado inactivo (un estado F).

Sintaxis

DXGKDDISETPOWERCOMPONENTFSTATE Dxgkddisetpowercomponentfstate;

NTSTATUS Dxgkddisetpowercomponentfstate(
  IN_CONST_HANDLE DriverContext,
  UINT ComponentIndex,
  UINT FState
)
{...}

Parámetros

DriverContext

Identificador de un bloque de contexto asociado a un adaptador de pantalla. La función DxgkDdiAddDevice del controlador de miniporte de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de DirectX.

ComponentIndex

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

FState

Valor de estado F que el controlador de miniporte de pantalla ha notificado al subsistema del kernel de gráficos de DirectX.

Valor devuelto

Devuelve STATUS_SUCCESS si se realiza correctamente; de lo contrario, devuelve STATUS_INVALID_PARAMETER.

Comentarios

El sistema operativo llama a DxgkDdiSetPowerComponentFState solo si el controlador de miniporte de pantalla indica la compatibilidad estableciendo DXGK_DRIVERCAPS. SupportRuntimePowerManagement en TRUE.

Nota Para evitar un posible interbloqueo, no llame a la función DxgkCbSetPowerComponentActive hasta que esta función haya devuelto.

Cuando el controlador de minipuerto de pantalla realiza una transición de un componente de alimentación del estado F0 (totalmente activado) a otro estado F, debe guardar el contexto necesario para restaurar posteriormente el componente al estado F0.

Power Management Framework solo realiza la transición de un componente al estado F0 o desde este.

Esta función se puede llamar simultáneamente desde varios subprocesos de ejecución. Sin embargo, solo un subproceso a la vez puede llamar a esta función para controlar un componente determinado.

El sistema operativo garantiza que esta función sigue el modo de sincronización de nivel cero tal y como se define en Subprocesos y Nivel cero de sincronización.

Requisitos

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