DXGKDDISETPOWERCOMPONENTFSTATE-Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

Wird vom Microsoft DirectX-Grafikkernsubsystem aufgerufen, um eine Energiekomponente in einen Leerlaufzustand (F-Zustand) zu überstellen.

Syntax

DXGKDDISETPOWERCOMPONENTFSTATE Dxgkddisetpowercomponentfstate;

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

Parameter

DriverContext

Ein Handle für einen Kontextblock, der einem Grafikkarte zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Anzeigeminiporttreibers hat dieses Handle zuvor für das DirectX-Grafikkernsubsystem bereitgestellt.

ComponentIndex

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

FState

Ein F-Zustandswert, den der Anzeigeminiporttreiber an das DirectX-Grafikkernsubsystem gemeldet hat.

Rückgabewert

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

Hinweise

Das Betriebssystem ruft DxgkDdiSetPowerComponentFState nur auf, wenn der Anzeigeminiporttreiber unterstützung durch Festlegen DXGK_DRIVERCAPS angibt. SupportRuntimePowerManagement auf TRUE.

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

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

Das Power Management Framework überwechselt eine Komponente nur in oder aus dem F0-Zustand.

Diese Funktion kann gleichzeitig von mehreren Ausführungsthreads aufgerufen werden. Diese Funktion kann jedoch jeweils nur von einem Thread aufgerufen werden, um eine bestimmte Komponente zu steuern.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Desktop
Kopfzeile	d3dkmddi.h
IRQL	<=DISPATCH_LEVEL