Freigeben über


DXGKCB_COMPLETEFSTATETRANSITION Rückruffunktion (d3dkmddi.h)

DXGKCB_COMPLETEFSTATETRANSITION benachrichtigt den Porttreiber, dass eine Energiekomponente den F-Zustandsübergang abgeschlossen hat.

Syntax

DXGKCB_COMPLETEFSTATETRANSITION DxgkcbCompletefstatetransition;

void DxgkcbCompletefstatetransition(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex
)
{...}

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.

Rückgabewert

Nichts

Bemerkungen

Bei der Komponentenregistrierung sollte der Miniporttreiber alle Leistungskomponenten angeben, für die die DXGKCB_COMPLETEFSTATETRANSITION-Funktion aufgerufen werden muss, indem die DXGK_POWER_COMPONENT_FLAGSfestgelegt wird.DriverCompletesFStateTransition Mitglied auf 1. Wenn dieses Element festgelegt ist, muss der Treiber diese Funktion entweder synchron oder asynchron aufrufen. Wenn dieses Element dagegen nicht festgelegt ist, sollte der Treiber diese Funktion nicht aufrufen.

Anmerkung

Wenn DXGK_POWER_COMPONENT_FLAGS.DriverCompletesFStateTransition festgelegt wurde, aber der Treiber ruft diese Funktion nicht auf, Deadlocks können auftreten.

Das Windows Power Management Framework garantiert, dass keine neue Übergangsanforderung für die Komponente gesendet wird, bis diese Funktion aufgerufen wird.

In der Regel erwartet der Porttreiber, dass beim Zurückgeben dieser Funktion der F-Zustandsübergang abgeschlossen ist. Es kann Szenarien geben, wenn der Miniporttreiber den Übergang nicht synchron abschließen kann, z. B. wenn der Display-Miniporttreiber die Übergänge bei DISPATCH_LEVELnicht abschließen kann oder andere Energiekomponenten aktiviert werden muss. Diese Funktion hilft dem Miniporttreiber, den F-Zustandsübergang asynchron abzuschließen.

DXGKCB_XXX Funktionen werden von Dxgkrnlimplementiert. Um diese Rückruffunktion zu verwenden, legen Sie die Member von DXGKARGCB_ALLOCATEPAGESFORMDL fest, und rufen Sie dann DxgkCbCompleteFStateTransition über die DXGKRNL_INTERFACEauf.

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

Siehe auch

DXGK_POWER_COMPONENT_FLAGS

DXGKRNL_INTERFACE