DXGKCB_SETPOWERCOMPONENTLATENCY fonction de rappel (d3dkmddi.h)
Un pilote miniport d’affichage appelle DXGKCB_SETPOWERCOMPONENTLATENCY pour définir la tolérance de latence pour un composant de puissance de type DXGK_POWER_COMPONENT_OTHER.
Syntaxe
DXGKCB_SETPOWERCOMPONENTLATENCY DxgkcbSetpowercomponentlatency;
void DxgkcbSetpowercomponentlatency(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex,
[in] ULONGLONG Latency
)
{...}
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] Latency
La tolérance de latence , la durée maximale, en unités de 100 nanosecondes, que le pilote de miniport d’affichage doit prendre pour réveiller un composant d’alimentation d’un état inactif. Le Power Management Framework utilise ces informations pour sélectionner un état d’inactivité approprié pour le composant qui ne respecte pas la tolérance de latence demandée. La tolérance de latence spécifiée par latence reste effective 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 tolérance de latence pour d’autres types de composants.
DXGKCB_XXX fonctions sont implémentées par Dxgkrnl. Pour utiliser cette fonction de rappel, appelez DxgkCbSetPowerComponentLatency 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 tolérance de latence spécifiée par de latence.
Si le pilote définit latence 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 |