DXGKCB_SETPOWERCOMPONENTLATENCY fonction de rappel (d3dkmddi.h)

  • Article

Un pilote miniport d’affichage appelle DXGKCB_SETPOWERCOMPONENTLATENCY pour définir la tolérance de latence d’un composant d’alimentation 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 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

Tolérance de latence (durée maximale, en unités de 100 nanosecondes) que le pilote miniport d’affichage doit prendre pour réveiller un composant d’alimentation d’un état inactif. Power Management Framework utilise ces informations pour sélectionner un état d’inactivité approprié pour le composant qui ne viole pas la tolérance de latence demandée. La tolérance de latence spécifiée par Latence reste en vigueur jusqu’à ce que le pilote appelle à nouveau cette fonction pour la mettre à jour. Consultez la section Notes.

Valeur de retour

None

Remarques

Notes

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, power Management Framework peut modifier l’état F du composant pour répondre à la tolérance de latence spécifiée par Latence.

Si le pilote définit la 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 à un état F inférieur à F0.

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 (inclure D3dkmddi.h)
IRQL <= DISPATCH_LEVEL

Voir aussi

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice