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