DXGKDDISETPOWERCOMPONENTFSTATE-Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Vom Microsoft DirectX-Grafik-Kernelsubsystem aufgerufen, um eine Energiekomponente in einen Leerlaufzustand (einen F-Zustand) zu übertragen.

Syntax

DXGKDDISETPOWERCOMPONENTFSTATE Dxgkddisetpowercomponentfstate;

NTSTATUS Dxgkddisetpowercomponentfstate(
  IN_CONST_HANDLE DriverContext,
  UINT ComponentIndex,
  UINT FState
)
{...}

Parameter

DriverContext

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Display-Miniporttreibers stellt dieses Handle zuvor für das DirectX-Grafik-Kernel-Subsystem bereit.

ComponentIndex

Der durch DXGKARG_QUERYADAPTERINFOangegebene Leistungskomponentenindex.pInputData- in einem Aufruf der DxgkDdiQueryAdapterInfo-Funktion.

FState

Ein F-Zustandswert, den der Display-Miniporttreiber dem DirectX-Grafik-Kernelsubsystem gemeldet hat.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn er erfolgreich ist; andernfalls wird STATUS_INVALID_PARAMETER zurückgegeben.

Bemerkungen

Das Betriebssystem ruft DxgkDdiSetPowerComponentFState nur dann auf, wenn der Miniporttreiber die Unterstützung durch Festlegen DXGK_DRIVERCAPSangibt.SupportRuntimePowerManagementTRUE.

Hinweis Um ein mögliches Deadlock zu vermeiden, rufen Sie die DxgkCbSetPowerComponentActive- funktion erst auf, wenn diese Funktion zurückgegeben wurde.

Wenn der Anzeige-Miniporttreiber eine Energiekomponente vom F0-Zustand (vollständig aktiviert) in einen anderen F-Zustand übergibt, sollte der Kontext gespeichert werden, der erforderlich ist, um die Komponente später wieder in den F0-Zustand zurückzusetzen.

Das Power Management Framework nur eine Komponente in oder vom F0-Zustand übergibt.

Diese Funktion kann über mehrere Ausführungsthreads gleichzeitig aufgerufen werden. Diese Funktion kann jedoch jeweils nur ein Thread aufrufen, um eine bestimmte Komponente zu steuern.

Das Betriebssystem garantiert, dass diese Funktion dem Synchronisierungsmodus auf Nullebene folgt, wie in Threading- und Synchronisierung zero Leveldefiniert.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8
mindestens unterstützte Server-	Windows Server 2012
Zielplattform-	Desktop
Header-	d3dkmddi.h
IRQL-	<=DISPATCH_LEVEL