DXGKCB_SETPOWERCOMPONENTACTIVE fonction de rappel (d3dkmddi.h)
Un pilote miniport d’affichage appelle DXGKCB_SETPOWERCOMPONENTACTIVE pour accéder à un composant d’alimentation. Une fois cette fonction retournée, le pilote miniport d’affichage peut modifier les paramètres matériels du composant.
Syntaxe
DXGKCB_SETPOWERCOMPONENTACTIVE DxgkcbSetpowercomponentactive;
void DxgkcbSetpowercomponentactive(
[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
Chaque appel à cette fonction doit être associé à un appel à la fonction DXGKCB_SETPOWERCOMPONENTIDLE pour indiquer que le matériel du composant n’est plus nécessaire.
Lorsque cette fonction est appelée, le nombre de références actif du composant est augmenté 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.
Lors de l’appel de cette fonction, le pilote miniport d’affichage peut recevoir un appel à la fonction DxgkDdiSetPowerComponentFState sur un autre thread d’exécution.
DXGKCB_XXX fonctions sont implémentées par Dxgkrnl. Pour utiliser cette fonction de rappel, appelez DxgkCbSetPowerComponentActive via le DXGKRNL_INTERFACE.
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 | PASSIVE_LEVEL |