DXGKCB_SETPOWERCOMPONENTRESIDENCY fonction de rappel (d3dkmddi.h)

  • Article

Un pilote miniport d’affichage en mode noyau appelle DXGKCB_SETPOWERCOMPONENTRESIDENCY pour définir la résidence attendue pour un composant d’alimentation 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 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 (la durée maximale, en unités de 100 nanosecondes) pendant laquelle le pilote miniport d’affichage s’attend à ce qu’un composant d’alimentation reste inactif une fois qu’il entre dans 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 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. 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 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, 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.

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