DXGKCB_SETPOWERCOMPONENTRESIDENCY Rückruffunktion (d3dkmddi.h)
Ein Kernelmodus-Miniporttreiber ruft DXGKCB_SETPOWERCOMPONENTRESIDENCY auf, um die erwartete Residency für eine Energiekomponente vom Typ DXGK_POWER_COMPONENT_OTHERfestzulegen.
Syntax
DXGKCB_SETPOWERCOMPONENTRESIDENCY DxgkcbSetpowercomponentresidency;
void DxgkcbSetpowercomponentresidency(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex,
[in] ULONGLONG Residency
)
{...}
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.
[in] Residency
Der erwartete Aufenthalt – die maximale Zeit in Einheiten von 100 Nanosekunden – dass der Display-Miniporttreiber erwartet, dass eine Energiekomponente im Leerlauf bleibt, nachdem sie in einen Leerlaufzustand gelangt. Das Power Management Framework verwendet diese Informationen, um einen geeigneten Leerlaufstatus für die Komponente auszuwählen, die nicht gegen den angeforderten Wohnsitz verstößt. Der von Residency angegebene Residency- bleibt wirksam, bis der Treiber diese Funktion erneut aufruft, um sie zu aktualisieren. Siehe Anmerkungen.
Rückgabewert
Nichts
Bemerkungen
Anmerkung
Der Miniporttreiber sollte diese Funktion nur aufrufen, wenn der Komponententyp DXGK_POWER_COMPONENT_OTHERist. Das DirectX-Grafik-Kernelsubsystem legt den erwarteten Residency-Wert für andere Komponententypen fest.
DXGKCB_XXX Funktionen werden von Dxgkrnlimplementiert. Rufen Sie DxgkCbSetPowerComponentResidency über die DXGKRNL_INTERFACEauf, um diese Rückruffunktion zu verwenden.
Wenn sich die Energiekomponente im Leerlauf befindet, wenn diese Funktion aufgerufen wird, kann das Power Management Framework den F-Zustand der Komponente ändern, um den erwarteten Residency-Wert zu erfüllen, der durch Residency-angegeben wird.
Wenn der Treiber Residency- auf einen Wert von PO_FX_UNKNOWN_TIME festlegt (definiert in Wdm.h), kann das Power Engine Plug-In (PEP) die Komponente möglicherweise nicht auf einen F-Zustand unter F0 festlegen.
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- | <= DISPATCH_LEVEL |