PPUT_SCATTER_GATHER_LIST コールバック関数 (wdm.h)

PutScatterGatherList ルーチンは、以前に割り当てられたマップ レジスタと、散布/収集 DMA で使用される散布/収集リストを解放します。

構文

PPUT_SCATTER_GATHER_LIST PputScatterGatherList;

void PputScatterGatherList(
  [in] PDMA_ADAPTER DmaAdapter,
  [in] PSCATTER_GATHER_LIST ScatterGather,
  [in] BOOLEAN WriteToDevice
)
{...}

パラメーター

[in] DmaAdapter

バス マスター アダプターまたは DMA コントローラーを表す IoGetDmaAdapter によって返されるDMA_ADAPTER構造体へのポインター。

[in] ScatterGather

GetScatterGatherList によって以前に返されたSCATTER_GATHER_LIST構造体へのポインター。

[in] WriteToDevice

DMA 転送の方向を示します。バッファーからデバイスへの転送には TRUE を、それ以外の場合は FALSE を 指定します。

戻り値

なし

解説

PutScatterGatherList は、名前で直接呼び出すことができるシステム ルーチンではありません。 このルーチンは、 DMA_OPERATIONS 構造体で返されるアドレスからのポインターによってのみ呼び出されます。 ドライバーは、 IoGetDmaAdapter を呼び出して、このルーチンのアドレスを取得します。

ドライバーは、散布/収集 I/O の完了後に PutScatterGatherList を呼び出す必要があります。 このルーチンは、アダプター バッファーをフラッシュし、マップ レジスタを解放し、マップを解除して、関連付けられている MCTL を解放します。 さらに、このルーチンは、 以前に GetScatterGatherList によって割り当てられた場合、散布図/収集リストを解放します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 以降のバージョンの Windows で使用できます。 Windows 98 または Windows Me ではサポートされていません。
対象プラットフォーム	デスクトップ
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
IRQL	DISPATCH_LEVEL
DDI コンプライアンス規則	IrqlDispatch(storport)、IrqlDispatch(storport)、 IrqlDispatch(wdm)

こちらもご覧ください

DMA_ADAPTER

DMA_OPERATIONS

GetScatterGatherList

IoGetDmaAdapter

SCATTER_GATHER_LIST