VideoPortCompleteDma 関数 (video.h)

  • [アーティクル]

VideoPortCompleteDma 関数は、DMA 転送操作の最後にバス マスター アダプターの内部キャッシュに残っているデータをフラッシュし、事前に割り当てられたマップ レジスタと、散布/収集 DMA 操作で使用される散布/収集リストを解放します。

構文

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortCompleteDma(
  [in] IN PVOID                   HwDeviceExtension,
  [in] IN PVP_DMA_ADAPTER         VpDmaAdapter,
  [in] IN PVP_SCATTER_GATHER_LIST VpScatterGather,
  [in] IN BOOLEAN                 WriteToDevice
);

パラメーター

[in] HwDeviceExtension

ミニポート ドライバーのデバイス拡張機能へのポインター。

[in] VpDmaAdapter

バス マスター アダプターを表す VP_DMA_ADAPTER 構造体へのポインター。 この構造体は 、VideoPortGetDmaAdapter の呼び出しによって返されました。

[in] VpScatterGather

以前 にミニポート ドライバー コールバック ルーチン HwVidExecuteDma に渡されたVP_SCATTER_GATHER_LIST構造体へのポインター。

[in] WriteToDevice

DMA 転送の方向を指定します。 値 TRUE はバッファーからデバイスへの転送を表し、FALSE の値はデバイスからバッファーへの転送を表します。

戻り値

VideoPortCompleteDma はNO_ERRORを返します。

注釈

ビデオ ミニポート ドライバーは、DMA 転送が完了した後、システム リソースを解放する VideoPortCompleteDma をすぐに呼び出す必要があります。

VideoPortCompleteDma が呼び出されると、VideoPortStartDma によって構築された散布/収集リストが無効になることに注意することが重要です。

要件

要件 値
サポートされている最小のクライアント Windows XP 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム デスクトップ
Header video.h (Video.h を含む)
Library Videoprt.lib
[DLL] Videoprt.sys
IRQL <=DISPATCH_LEVEL

こちらもご覧ください

VP_DMA_ADAPTER

VP_SCATTER_GATHER_LIST

VideoPortGetDmaAdapter

VideoPortStartDma