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

IoGetDmaAdapter 所傳回之DMA_ADAPTER結構的指標，代表總線主機適配卡或 DMA 控制器。

[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)

另請參閱

DMA_ADAPTER

DMA_OPERATIONS

GetScatterGatherList

IoGetDmaAdapter

SCATTER_GATHER_LIST