PDXGK_FSTATE_NOTIFICATION Rückruffunktion (d3dkmthk.h)

Wird vom Clienttreiber implementiert, um eine Statusbenachrichtigung auszusetzen.

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 für das Grafikgerät bereitgestellt werden sollte.

ComponentIndex

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

NewFState

Der F-Zustand, in den übergehen soll.

PreNotification

Gibt an, dass eine Benachrichtigung bereitgestellt werden soll.

PrivateHandle

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

Rückgabewert

Keine

Bemerkungen

Alle Rückrufe, die von Dxgkrnl zu diesem Rückruf vorgenommen werden, können bis zu DISPATCH_LEVEL aufgerufen werden (z. B. sollte der Nicht-Grafiktreiber keine dieser Benachrichtigungen blockieren). Rückrufe werden nur für DXGK_POWER_COMPONENT_SHARED Energiekomponenten vom Typ ausgeführt.

Vor dem Übergang von F-Zuständen werden Vorabbenachrichtigungen bereitgestellt. Rückrufe für Vervollständigungsbenachrichtigungen (PreNotification==FALSE) werden als Teil des DxgkCbCompleteFStateTransition-Rückrufs des Grafiktreibers ausgegeben. Das heißt, alle gemeinsam genutzten Energiekomponenten werden über den Abschluss des F-Zustandsübergangs benachrichtigt, bevor DxgkCbCompleteFStateTransition zurückgegeben wird.

Anforderungen