DXGKCB_SETPOWERCOMPONENTRESIDENCY Rückruffunktion (d3dkmddi.h)
Ein Display-Miniporttreiber im Kernelmodus ruft DXGKCB_SETPOWERCOMPONENTRESIDENCY auf, um die erwartete Residenz für eine Energiekomponente vom Typ DXGK_POWER_COMPONENT_OTHER festzulegen.
Syntax
DXGKCB_SETPOWERCOMPONENTRESIDENCY DxgkcbSetpowercomponentresidency;
void DxgkcbSetpowercomponentresidency(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex,
[in] ULONGLONG Residency
)
{...}
Parameter
[in] hAdapter
Ein Handle für die Grafikkarte. Der Anzeige-Miniporttreiber empfängt das Handle vom DeviceHandle-Member der DXGKRNL_INTERFACE-Struktur in einem Aufruf der DxgkDdiStartDevice-Funktion .
[in] ComponentIndex
Der von DXGKARG_QUERYADAPTERINFO angegebene Energiekomponentenindex. pInputData in einem Aufruf der DxgkDdiQueryAdapterInfo-Funktion .
[in] Residency
Die erwartete Residenz – die maximale Zeit in Einheiten von 100 Nanosekunden –, die der Anzeige-Miniporttreiber erwartet, dass eine Energiekomponente im Leerlauf verbleibt, nachdem sie in einen Leerlaufzustand wechselt. Das Power Management Framework verwendet diese Informationen, um einen geeigneten Leerlaufzustand für die Komponente auszuwählen, der nicht gegen die angeforderte Residenz verstößt. Die erwartete Residenz, die von Residency angegeben wird, bleibt in Kraft, bis der Treiber diese Funktion erneut aufruft, um sie zu aktualisieren. Siehe Hinweise.
Rückgabewert
Keine
Bemerkungen
Hinweis
Der Display-Miniporttreiber sollte diese Funktion nur aufrufen, wenn der Komponententyp DXGK_POWER_COMPONENT_OTHER ist. Das DirectX-Grafikkernsubsystem legt den erwarteten Residenzwert für andere Komponententypen fest.
DXGKCB_XXX Funktionen werden von Dxgkrnl implementiert. Um diese Rückruffunktion zu verwenden, rufen Sie DxgkCbSetPowerComponentResidency über die DXGKRNL_INTERFACE auf.
Wenn sich die Energiekomponente beim Aufrufen dieser Funktion im Leerlauf befindet, ändert das Power Management Framework möglicherweise den F-Zustand der Komponente, um den erwarteten Residenzwert zu erfüllen, der von Residency angegeben wird.
Wenn der Treiber Residency auf den Wert PO_FX_UNKNOWN_TIME (definiert in Wdm.h) festlegt, kann das Power Engine Plug-In (PEP) die Komponente möglicherweise nicht auf einen F-Zustand festlegen, der niedriger als F0 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 | <= DISPATCH_LEVEL |