DXGKCB_SETPOWERCOMPONENTLATENCY Rückruffunktion (d3dkmddi.h)
Ein Anzeige-Miniporttreiber ruft DXGKCB_SETPOWERCOMPONENTLATENCY auf, um die Latenztoleranz für eine Leistungskomponente vom Typ DXGK_POWER_COMPONENT_OTHERfestzulegen.
Syntax
DXGKCB_SETPOWERCOMPONENTLATENCY DxgkcbSetpowercomponentlatency;
void DxgkcbSetpowercomponentlatency(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex,
[in] ULONGLONG Latency
)
{...}
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] Latency
Die Latenztoleranz – die maximale Zeit in Einheiten von 100 Nanosekunden –, die der Miniporttreiber für die Anzeige benötigt, um eine Energiekomponente aus einem Leerlaufzustand zu wecken. Das Power Management Framework verwendet diese Informationen, um einen geeigneten Leerlaufstatus für die Komponente auszuwählen, die nicht gegen die angeforderte Latenztoleranz verstößt. Die durch Latenz angegebene Latenztoleranz 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 Latenztoleranzwert für andere Komponententypen fest.
DXGKCB_XXX Funktionen werden von Dxgkrnlimplementiert. Rufen Sie DxgkCbSetPowerComponentLatency ü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 die durch Latenzangegebene Latenztoleranz zu erfüllen.
Wenn der Treiber Latenz 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 |