PDXGK_FSTATE_NOTIFICATION Rückruffunktion (d3dkmthk.h)

Artikel
02/06/2025

Vom Clienttreiber implementiert, um eine Statusbenachrichtigung ausstellen zu können.

Syntax

PDXGK_FSTATE_NOTIFICATION PdxgkFstateNotification;

void PdxgkFstateNotification(
  PVOID GraphicsDeviceHandle,
  ULONG ComponentIndex,
  UINT NewFState,
  BOOLEAN PreNotification,
  PVOID PrivateHandle
)
{...}

Parameter

GraphicsDeviceHandle

Ein undurchsichtiges Handle, das beim Ausführen von Rückrufen an das Grafikgerät bereitgestellt werden soll.

ComponentIndex

Der Index der Komponente. Im Allgemeinen ist dies der Index, der vom Grafikkartenadapter verwendet wird. Die Ausnahme gilt für LDA-Szenarien, in denen das HIWORD des ComponentIndex den Adapterindex angibt, wie getan, wenn der Grafiktreiber vom Grafikkern für F-Zustandsänderungen in LDA-Szenarien aufgerufen wird.

NewFState

Der zu übersteigende F-Zustand.

PreNotification

Gibt an, dass eine Benachrichtigung bereitgestellt werden soll.

PrivateHandle

Ein undurchsichtiges Handle, das in allen Rückrufen bereitgestellt wird. Dieser Handle muss global eindeutig sein, daher sollte ein Zeiger auf das PDO oder FDO des aufrufenden Treibers verwendet werden.

Rückgabewert

Nichts

Bemerkungen

Alle von Dxgkrnl an diesen Rückruf vorgenommenen Rückrufe können bis zu DISPATCH_LEVEL aufgerufen werden (z. B. sollte der Nicht-Grafiktreiber keines dieser Benachrichtigungen blockieren). Rückrufe werden nur für DXGK_POWER_COMPONENT_SHARED Typ-Leistungskomponenten vorgenommen.

Vorabbenachrichtigungen werden vor dem Übergang von F-Zuständen bereitgestellt. Abschlussbenachrichtigungsrückrufe (PreNotification==FALSE) werden als Teil des DxgkCbCompleteFStateTransition Rückrufs des Grafiktreibers ausgegeben. Das heißt, alle Komponenten für gemeinsame Energie werden vor der Rückgabe von DxgkCbCompleteFStateTransition über den Abschluss des F-Zustands benachrichtigt.

Anforderungen

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

Freigeben über