PMINIPORT_SYNCHRONIZE_ROUTINEコールバック関数 (video.h)

[アーティクル]
03/05/2024

HwVidSynchronizeExecutionCallback は、 VideoPortSynchronizeExecution への呼び出しで渡される省略可能なミニポートドライバー関数です。

構文

PMINIPORT_SYNCHRONIZE_ROUTINE PminiportSynchronizeRoutine;

BOOLEAN PminiportSynchronizeRoutine(
  PVOID Context
)
{...}

パラメーター

Context

VideoPortSynchronizeExecution を介してコールバックルーチンに渡されるコンテキストデータへのポインター。通常、これはデバイス拡張機能へのポインターか、デバイス拡張機能内のオフセットです。

戻り値

操作が成功した場合、 HwVidSynchronizeExecutionCallback は TRUE を返します。

注釈

HwVidInterrupt 関数とメモリを共有する 1 つ以上の関数を持つミニポートドライバーには、HwVidSynchronizeExecutionCallback 関数が必要です。 HwVidInterrupt とメモリを共有する関数は、共有メモリ領域のデータの整合性を維持するために、HwVidSynchronizeExecutionCallback 関数を使用して VideoPortSynchronizeExecution を呼び出す必要があります。つまり、特定の時点で共有領域の状態を更新できるのは、 HwVidSynchronizeExecutionCallback 関数と HwVidInterrupt 関数のいずれか 1 つだけです。

割り込みを生成しないアダプターのミニポートドライバーは、このようなドライバーが相対的に高い実行時優先度でいくつかの重要な作業を行う必要がある場合に VideoPortSynchronizeExecutionExecution に渡される HwVidSynchronizeExecutionCallback 関数を持つことができます。たとえば、 SvgaHwIoPortXxx 関数を持つ VGA 互換ミニポートドライバー ( 「SVGA 関数」を参照) には、ドライバーバッファーと検証済みのアプリケーション発行 I/O をアダプターに転送する役割を担う HwVidSynchronizeExecutionCallback 関数がある場合があります。

HwVidSynchronizeExecutionCallback をページング可能にすることはできません。