Fonction de rappel DXGKDDISETPOWERCOMPONENTFSTATE (d3dkmddi.h)

Article
08/07/2023

Appelé par le sous-système du noyau graphique Microsoft DirectX pour passer un composant d’alimentation à un état inactif (état F).

Syntaxe

DXGKDDISETPOWERCOMPONENTFSTATE Dxgkddisetpowercomponentfstate;

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

Paramètres

DriverContext

Handle d’un bloc de contexte associé à un adaptateur d’affichage. La fonction DxgkDdiAddDevice du pilote miniport d’affichage a précédemment fourni ce handle au sous-système du noyau graphique DirectX.

ComponentIndex

Index du composant d’alimentation spécifié par DXGKARG_QUERYADAPTERINFO. pInputData dans un appel à la fonction DxgkDdiQueryAdapterInfo .

FState

Valeur d’état F que le pilote de miniport d’affichage a signalée au sous-système du noyau graphique DirectX.

Valeur retournée

Retourne STATUS_SUCCESS si elle réussit ; sinon, elle retourne STATUS_INVALID_PARAMETER.

Remarques

Le système d’exploitation appelle DxgkDdiSetPowerComponentFState uniquement si le pilote de miniport d’affichage indique la prise en charge en définissant DXGK_DRIVERCAPS. SupportRuntimePowerManagement à TRUE.

Note Pour éviter un blocage possible, n’appelez pas la fonction DxgkCbSetPowerComponentActive tant que cette fonction n’est pas retournée.

Lorsque le pilote de miniport d’affichage passe un composant d’alimentation de l’état F0 (entièrement activé) à un autre état F, il doit enregistrer le contexte nécessaire pour restaurer ultérieurement le composant à l’état F0.

Power Management Framework effectue uniquement la transition d’un composant vers ou depuis l’état F0.

Cette fonction peut être appelée simultanément à partir de plusieurs threads d’exécution. Toutefois, un seul thread à la fois peut appeler cette fonction pour contrôler un composant particulier.

Le système d’exploitation garantit que cette fonction suit le mode de synchronisation de niveau zéro tel que défini dans Threading et Synchronisation Niveau zéro.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3dkmddi.h
IRQL	<=DISPATCH_LEVEL