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 |