DXGKCB_SETPOWERCOMPONENTACTIVE fonction de rappel (d3dkmddi.h)

Article
02/26/2024

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 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

None

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 actives du composant est augmenté de 1. 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 égal à zéro.

Lors de l’appel de cette fonction, le pilote de 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.

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	PASSIVE_LEVEL