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 呼び出す必要があります。 このルーチンは、アダプター バッファーをフラッシュし、マップ レジスタを解放し、マップを解除して、関連付けられている MDL を解放します。 さらに、このルーチンは、以前に GetScatterGatherList によって割り当てられていた場合、散布図/収集リスト解放します。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 以降のバージョンの Windows で使用できます。 Windows 98 または Windows Me ではサポートされていません。 |
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
IRQL | DISPATCH_LEVEL |
DDI コンプライアンス規則 を する | IrqlDispatch(storport)、IrqlDispatch(storport)、IrqlDispatch(wdm) |
関連項目
GetScatterGatherList を する
IoGetDmaAdapter の