DXGKCB_SETPOWERCOMPONENTIDLE Rückruffunktion (d3dkmddi.h)

Ein Display-Miniporttreiber ruft DXGKCB_SETPOWERCOMPONENTIDLE auf, um das DirectX-Grafikkernsubsystem zu benachrichtigen, dass eine Energiekomponente nicht mehr benötigt wird. Nachdem diese Funktion zurückgegeben wurde, darf der Anzeigeminiporttreiber die Hardwareeinstellungen der Komponente nicht ändern.

Syntax

DXGKCB_SETPOWERCOMPONENTIDLE DxgkcbSetpowercomponentidle;

void DxgkcbSetpowercomponentidle(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex
)
{...}

Parameter

[in] hAdapter

Ein Handle für den Grafikkarten. Der Anzeigeminiporttreiber empfängt das Handle vom DeviceHandle-Member der DXGKRNL_INTERFACE-Struktur in einem Aufruf seiner DxgkDdiStartDevice-Funktion .

[in] ComponentIndex

Der durch DXGKARG_QUERYADAPTERINFO angegebene Leistungskomponentenindex. pInputData in einem Aufruf der DxgkDdiQueryAdapterInfo-Funktion .

Rückgabewert

Keine

Bemerkungen

Der Display-Miniporttreiber kann diese Funktion für jeden Typ von Energiekomponente aufrufen, auch wenn das DirectX-Grafikkernsubsystem den Leerlaufzustand der Komponente verwaltet.

DXGKCB_XXX Funktionen werden von Dxgkrnl implementiert. Um diese Rückruffunktion zu verwenden, rufen Sie DxgkCbSetPowerComponentIdle über den DXGKRNL_INTERFACE auf. Jeder Aufruf dieser Funktion muss mit einem Aufruf der DXGKCB_SETPOWERCOMPONENTACTIVE-Funktion gekoppelt werden.

Wenn diese Funktion aufgerufen wird, wird die aktive Referenzanzahl der Komponente um 1 verringert. Das Power Management Framework verwaltet die Verweisanzahl und versetzt die Komponente nur dann in einen niedrigeren F-Zustand, wenn die Verweisanzahl 0 ist.

Diese Funktion muss unter IRQL <= DISPATCH_LEVEL aufgerufen werden. Sie kann nur unter IRQL = DISPATCH_LEVEL aufgerufen werden, wenn der Komponententyp DXGK_POWER_COMPONENT_OTHER ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 (WDDM 1.2)
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Desktop
Kopfzeile	d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL	Weitere Informationen finden Sie im Abschnitt mit den Hinweisen.

Weitere Informationen

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGKCB_SETPOWERCOMPONENTACTIVE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice