DXGKCB_SETPOWERCOMPONENTRESIDENCY fonction de rappel (d3dkmddi.h)
Un pilote miniport en mode noyau appelle DXGKCB_SETPOWERCOMPONENTRESIDENCY pour définir la résidence attendue pour un composant de puissance de type DXGK_POWER_COMPONENT_OTHER.
Syntaxe
DXGKCB_SETPOWERCOMPONENTRESIDENCY DxgkcbSetpowercomponentresidency;
void DxgkcbSetpowercomponentresidency(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex,
[in] ULONGLONG Residency
)
{...}
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.
[in] Residency
La résidence attendue ( durée maximale, en unités de 100 nanosecondes) que le pilote miniport d’affichage attend qu’un composant d’alimentation reste inactif après qu’il entre dans un état inactif. L'Power Management Framework utilise ces informations pour sélectionner un état inactif approprié pour le composant qui n’enfreint pas la résidence demandée. La résidence attendue spécifiée par résidence reste en vigueur jusqu’à ce que le pilote appelle à nouveau cette fonction pour la mettre à jour. Voir les remarques.
Valeur de retour
Aucun
Remarques
Note
Le pilote miniport d’affichage doit appeler cette fonction uniquement si le type de composant est DXGK_POWER_COMPONENT_OTHER. Le sous-système du noyau graphique DirectX définit la valeur de résidence attendue pour d’autres types de composants.
DXGKCB_XXX fonctions sont implémentées par Dxgkrnl. Pour utiliser cette fonction de rappel, appelez DxgkCbSetPowerComponentResidency via le DXGKRNL_INTERFACE.
Si le composant d’alimentation est dans un état inactif lorsque cette fonction est appelée, l'Power Management Framework peut modifier l’état F du composant pour répondre à la valeur de résidence attendue spécifiée par résidence.
Si le pilote définit résidence sur une valeur de PO_FX_UNKNOWN_TIME (définie dans Wdm.h), le plug-in Power Engine (PEP) peut ne pas pouvoir définir le composant sur un état F inférieur à F0.
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 | <= DISPATCH_LEVEL |