DXGKCB_SETPOWERCOMPONENTIDLE fonction de rappel (d3dkmddi.h)
Un pilote miniport d’affichage appelle DXGKCB_SETPOWERCOMPONENTIDLE pour informer le sous-système du noyau graphique DirectX qu’un composant d’alimentation n’est plus nécessaire. Une fois cette fonction retournée, le pilote miniport d’affichage ne doit pas modifier les paramètres matériels du composant.
Syntaxe
DXGKCB_SETPOWERCOMPONENTIDLE DxgkcbSetpowercomponentidle;
void DxgkcbSetpowercomponentidle(
[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
Aucun
Remarques
Le pilote miniport d’affichage peut appeler cette fonction pour n’importe quel type de composant d’alimentation, même si le sous-système du noyau graphique DirectX gère l’état inactif du composant.
DXGKCB_XXX fonctions sont implémentées par Dxgkrnl. Pour utiliser cette fonction de rappel, appelez DxgkCbSetPowerComponentIdle via le DXGKRNL_INTERFACE. Chaque appel à cette fonction doit être associé à un appel à la fonction DXGKCB_SETPOWERCOMPONENTACTIVE.
Lorsque cette fonction est appelée, le nombre de références actifs du composant est réduit de 1. Le Power Management Framework conserve le nombre de références et place le composant dans un état F inférieur uniquement lorsque le nombre de références devient zéro.
Cette fonction doit être appelée au <IRQL = DISPATCH_LEVEL. Il peut être appelé à IRQL = DISPATCH_LEVEL uniquement si le type de composant est DXGK_POWER_COMPONENT_OTHER.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8 (WDDM 1.2) |
| serveur minimum pris en charge | Windows Server 2012 |
| plateforme cible | Bureau |
| d’en-tête | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | Voir la section Remarques. |