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 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 .
Rückgabewert
Keine
Bemerkungen
Während der Komponentenregistrierung sollte der Display-Miniporttreiber alle Leistungskomponenten angeben, für die er die DXGKCB_COMPLETEFSTATETRANSITION-Funktion aufrufen muss, indem er die DXGK_POWER_COMPONENT_FLAGS festlegt. DriverCompletesFStateTransition-Member auf 1. Wenn dieser Member festgelegt ist, muss der Treiber diese Funktion entweder synchron oder asynchron aufrufen. Umgekehrt sollte der Treiber diese Funktion nicht aufrufen, wenn dieser Member nicht festgelegt ist.
Hinweis
Wenn DXGK_POWER_COMPONENT_FLAGS. DriverCompletesFStateTransition wurde festgelegt, aber der Treiber ruft diese Funktion nicht auf. Deadlocks können auftreten.
Das Windows-Energieverwaltungsframework garantiert, dass keine neue Übergangsanforderung für die Komponente gesendet wird, bis diese Funktion aufgerufen wird.
Normalerweise erwartet der Porttreiber, dass der F-Zustandsübergang abgeschlossen ist, wenn diese Funktion zurückgegeben wird. Es kann Szenarien geben, in dem der Display-Miniporttreiber den Übergang nicht synchron abschließen kann, z. B. wenn der Display-Miniporttreiber die Übergänge bei DISPATCH_LEVEL nicht abschließen kann oder andere Energiekomponenten aktiviert werden muss. Diese Funktion hilft dem Anzeigeminiporttreiber, den F-Zustandsübergang asynchron abzuschließen.
DXGKCB_XXX Funktionen werden von Dxgkrnl implementiert. Um diese Rückruffunktion zu verwenden, legen Sie die Member von DXGKARGCB_ALLOCATEPAGESFORMDL fest, und rufen Sie dann DxgkCbCompleteFStateTransition über die DXGKRNL_INTERFACE auf.
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 |