PMINIPORT_SYNCHRONIZE_ROUTINE video.h) (回呼函式

發行項
02/26/2024

HwVidSynchronizeExecutionCallback 是選擇性的迷你埠驅動程式函式，會傳入 VideoPortSynchronizeExecution 的呼叫。

語法

PMINIPORT_SYNCHRONIZE_ROUTINE PminiportSynchronizeRoutine;

BOOLEAN PminiportSynchronizeRoutine(
  PVOID Context
)
{...}

參數

Context

透過 VideoPortSynchronizeExecution 傳遞至回呼例程之內容數據的指標。通常，這是裝置延伸模組的指標或裝置延伸模組內的位移。

傳回值

如果作業成功， HwVidSynchronizeExecutionCallback 會傳回 TRUE。

備註

具有一或多個與 HwVidInterrupt 函式共用記憶體的迷你埠驅動程序必須具有 HwVidSynchronizeExecutionCallback 函式。與 HwVidInterrupt 共用記憶體的任何函式都必須使用 HwVidSynchronizeExecution 呼叫 VideoPortSynchronizeExecutionCallback 函式，以維護共用記憶體區域中數據的完整性。也就是說，在任何指定的時間，只有其中一個 HwVidSynchronizeExecutionCallback 和 HwVidInterrupt 函式可以更新共享區域中的狀態。

不產生中斷之適配卡的迷你埠驅動程式也可以有 HwVidSynchronizeExecutionCallback 函式，當這類驅動程式需要取得相對高運行時間優先順序完成的一些重要工作時，就會傳遞至 VideoPortSynchronizeExecution 。例如，VGA 相容的迷你埠驅動程式與 SvgaHwIoPortXxx 函式 (請參閱 SVGA Functions) 可能有 一個 HwVidSynchronizeExecutionCallback 函式，負責將驅動程式緩衝處理和已驗證的應用程式發行 I/O 傳送至配接器。

HwVidSynchronizeExecutionCallback 不得設為可分頁。