DXGKCB_SETPOWERCOMPONENTLATENCY Rückruffunktion (d3dkmddi.h)

Ein Display-Miniporttreiber ruft DXGKCB_SETPOWERCOMPONENTLATENCY auf, um die Latenztoleranz für eine Energiekomponente vom Typ DXGK_POWER_COMPONENT_OTHER festzulegen.

Syntax

DXGKCB_SETPOWERCOMPONENTLATENCY DxgkcbSetpowercomponentlatency;

void DxgkcbSetpowercomponentlatency(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex,
  [in] ULONGLONG Latency
)
{...}

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] Latency

Die Latenztoleranz – die maximale Zeit in Einheiten von 100 Nanosekunden –, die der Anzeige-Miniporttreiber benötigt, um eine Energiekomponente aus einem Leerlaufzustand zu wecken. Das Power Management Framework verwendet diese Informationen, um einen geeigneten Leerlaufzustand für die Komponente auszuwählen, der die angeforderte Latenztoleranz nicht verletzt. Die durch Latenz angegebene Latenztoleranz bleibt wirksam, 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 Latenztoleranzwert für andere Komponententypen fest.

DXGKCB_XXX Funktionen werden von Dxgkrnl implementiert. Um diese Rückruffunktion zu verwenden, rufen Sie DxgkCbSetPowerComponentLatency ü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 die durch Latenz angegebene Latenztoleranz zu erfüllen.

Wenn der Treiber Latenz 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

Weitere Informationen

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice