DXGKCB_SETPOWERCOMPONENTIDLE Rückruffunktion (d3dkmddi.h)
Ein Anzeige-Miniporttreiber ruft DXGKCB_SETPOWERCOMPONENTIDLE auf, um das DirectX-Grafik-Kernel-Subsystem zu benachrichtigen, dass eine Energiekomponente nicht mehr benötigt wird. Nachdem diese Funktion zurückgegeben wurde, darf der Miniporttreiber 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 Anzeigeadapter. Der Anzeige-Miniporttreiber empfängt den Handle vom DeviceHandle Member der DXGKRNL_INTERFACE-Struktur in einem Aufruf der DxgkDdiStartDevice--Funktion.
[in] ComponentIndex
Der durch DXGKARG_QUERYADAPTERINFOangegebene Leistungskomponentenindex.pInputData- in einem Aufruf der funktion DxgkDdiQueryAdapterInfo.
Rückgabewert
Nichts
Bemerkungen
Der Display-Miniporttreiber kann diese Funktion für jede Art von Energiekomponente aufrufen, auch wenn das DirectX-Grafik-Kernel-Subsystem den Leerlaufstatus der Komponente verwaltet.
DXGKCB_XXX Funktionen werden von Dxgkrnlimplementiert. Rufen Sie DxgkCbSetPowerComponentIdle über die DXGKRNL_INTERFACEauf, um diese Rückruffunktion zu verwenden. 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 Referenzanzahl und platziert die Komponente nur dann in einen niedrigeren F-Zustand, wenn die Referenzanzahl null wird.
Diese Funktion muss bei IRQL-<= DISPATCH_LEVEL aufgerufen werden. Sie kann bei IRQL = DISPATCH_LEVEL nur aufgerufen werden, wenn der Komponententyp DXGK_POWER_COMPONENT_OTHERist.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 (WDDM 1.2) |
| mindestens unterstützte Server- | Windows Server 2012 |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL- | Siehe Abschnitt "Hinweise". |