DXGKDDISETPOWERCOMPONENTFSTATE, fonction de rappel (d3dkmddi.h)

Article
02/06/2025

Appelé par le sous-système du noyau graphique Microsoft DirectX pour passer d’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 vers un bloc de contexte associé à un adaptateur d’affichage. La fonction d’affichage du pilote miniport DxgkDdiAddDevice 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 miniport d’affichage a signalée au sous-système du noyau graphique DirectX.

Valeur de retour

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.SupportRuntimePowerManagementTRUE.

Remarque Pour éviter un blocage possible, n’appelez pas la fonction DxgkCbSetPowerComponentActive jusqu’à ce que cette fonction soit retournée.

Lorsque le pilote miniport d’affichage passe d’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.

Le 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 de niveau zéro.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8
serveur minimum pris en charge	Windows Server 2012
plateforme cible	Bureau
d’en-tête	d3dkmddi.h
IRQL	<=DISPATCH_LEVEL