DXGKCB_SYNCHRONIZE_EXECUTION回呼函式 (dispmprt.h)

DxgkCbSynchronizeExecution 函式會同步處理由顯示迷你埠驅動程序實作的指定函式，以及顯示迷你埠驅動程式的 DxgkDdiInterruptRoutine 函式。

語法

DXGKCB_SYNCHRONIZE_EXECUTION DxgkcbSynchronizeExecution;

NTSTATUS DxgkcbSynchronizeExecution(
  [in]  HANDLE DeviceHandle,
  [in]  PKSYNCHRONIZE_ROUTINE SynchronizeRoutine,
  [in]  PVOID Context,
  [in]  ULONG MessageNumber,
  [out] PBOOLEAN ReturnValue
)
{...}

參數

[in] DeviceHandle

表示顯示配接器的句柄。 顯示迷你埠驅動程式先前在傳遞至 DxgkDdiStartDevice 之 DXGKRNL_INTERFACE 結構的 DeviceHandle 成員中取得此句柄。

[in] SynchronizeRoutine

顯示迷你埠驅動程式所實作之函式的指標，會與 DxgkDdiInterruptRoutine 同步處理。 函式必須符合下列原型：

BOOLEAN SynchronizeRoutine(PVOID Context);

[in] Context

顯示迷你埠驅動程式所建立之內容區塊的指標，會傳遞至 SynchronizeRoutine。

[in] MessageNumber

將同步處理 SynchronizeRoutine 的中斷訊息數目。 如果中斷是以行為基礎，這個參數必須是零。

[out] ReturnValue

布爾值變數的指標，可接收 SynchronizeRoutine 的傳回值。

傳回值

DxgkCbSynchronizeExecution 會傳回下列其中一個值：

傳回碼	Description
STATUS_SUCCESS	此函數已成功。
STATUS_INVALID_PARAMETER	其中一個參數無效。
STATUS_UNSUCCESSFUL	函式無法同步執行，可能是因為中斷尚未連線。

規格需求

需求	值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台	桌面
標頭	dispmprt.h (包括 Dispmprt.h)
IRQL	<=DISPATCH_LEVEL

另請參閱

DxgkDdiInterruptRoutine

KeSynchronizeExecution