共用方式為


PDXGK_FSTATE_NOTIFICATION回呼函式 (d3dkmthk.h)

由客戶端驅動程序實作以發出狀態通知。

語法

PDXGK_FSTATE_NOTIFICATION PdxgkFstateNotification;

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

參數

GraphicsDeviceHandle

對圖形裝置進行回呼時,應該提供的不透明句柄。

ComponentIndex

元件的索引。 一般而言,這會是圖形配接器所使用的索引。 例外狀況是 LDA 案例,其中 ComponentIndex 的 HIWORD 表示配接器索引,如同在 LDA 案例中,圖形核心呼叫圖形驅動程式以進行 F 狀態變更時所完成。

NewFState

要轉換至的 F 狀態。

PreNotification

指出應該提供通知。

PrivateHandle

將在任何回呼中提供的不透明句柄。 此句柄必須是全域唯一的,因此應該使用呼叫驅動程式的 PDO 或 FDO 指標。

傳回值

備註

從 Dxgkrnl 到此回呼的所有回呼,最多可以呼叫DISPATCH_LEVEL (,例如,非圖形驅動程式不應該封鎖任何通知) 。 只會針對 DXGK_POWER_COMPONENT_SHARED 類型電源元件進行回呼。

在轉換 F 狀態之前,將會提供預先通知。 在圖形驅動程式的 DxgkCbCompleteFStateTransition 回呼中發出完成通知回呼 (PreNotification==FALSE) 。 也就是說,所有共用電源元件都會在傳回 DxgkCbCompleteFStateTransition 之前收到 F 狀態轉換完成的通知。

規格需求

需求
最低支援的用戶端 Windows 8
最低支援的伺服器 Windows Server 2012
標頭 d3dkmthk.h
IRQL <= DISPATCH_LEVEL