DXGKCB_COMPLETEFSTATETRANSITION fonction de rappel (d3dkmddi.h)
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 |