DXGKCB_COMPLETEFSTATETRANSITION fonction de rappel (d3dkmddi.h)

  • Article

DXGKCB_COMPLETEFSTATETRANSITION avertit le pilote de port qu’un composant d’alimentation a terminé la transition de l’état F.

Syntaxe

DXGKCB_COMPLETEFSTATETRANSITION DxgkcbCompletefstatetransition;

void DxgkcbCompletefstatetransition(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex
)
{...}

Paramètres

[in] hAdapter

Handle de l’adaptateur d’affichage. Le pilote de miniport d’affichage reçoit le handle du membre DeviceHandle de la structure DXGKRNL_INTERFACE dans un appel à sa fonction DxgkDdiStartDevice .

[in] ComponentIndex

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

Valeur de retour

None

Remarques

Lors de l’inscription du composant, le pilote de miniport d’affichage doit indiquer tous les composants d’alimentation pour lesquels il devra appeler la fonction DXGKCB_COMPLETEFSTATETRANSITION en définissant la DXGK_POWER_COMPONENT_FLAGS. DriverCompletesFStateTransition membre à 1. Lorsque ce membre est défini, le pilote doit appeler cette fonction de manière synchrone ou asynchrone. À l’inverse, si ce membre n’est pas défini, le pilote ne doit pas appeler cette fonction.

Notes

Si DXGK_POWER_COMPONENT_FLAGS. DriverCompletesFStateTransition a été défini, mais le pilote n’appelle pas cette fonction, des interblocages peuvent se produire.

L’infrastructure de gestion de l’alimentation Windows garantit qu’aucune nouvelle demande de transition n’est envoyée pour le composant tant que cette fonction n’est pas appelée.

En règle générale, le pilote de port s’attend à ce que lorsque cette fonction retourne, la transition de l’état F soit terminée. Il peut arriver que le pilote de miniport d’affichage ne puisse pas effectuer la transition de manière synchrone, par exemple si le pilote miniport d’affichage ne peut pas effectuer les transitions au DISPATCH_LEVEL, ou s’il doit activer d’autres composants d’alimentation. Cette fonction permet au pilote de miniport d’affichage d’effectuer la transition de l’état F de manière asynchrone.

DXGKCB_XXX fonctions sont implémentées par Dxgkrnl. Pour utiliser cette fonction de rappel, définissez les membres de DXGKARGCB_ALLOCATEPAGESFORMDL , puis appelez DxgkCbCompleteFStateTransition via le DXGKRNL_INTERFACE.

Configuration requise

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

Voir aussi

DXGK_POWER_COMPONENT_FLAGS

DXGKRNL_INTERFACE