共用方式為

StorPortPutScatterGatherList 函式 (storport.h)

  • 發行項

StorPortPutScatterGatherList 例程會釋放任何與先前由 StorPortBuildScatterGatherList 例程呼叫所建立之散佈/收集列表相關聯的資源。

語法

ULONG StorPortPutScatterGatherList(
  [in] PVOID                     HwDeviceExtension,
  [in] PSTOR_SCATTER_GATHER_LIST ScatterGatherList,
  [in] BOOLEAN                   WriteToDevice
);

參數

[in] HwDeviceExtension

主機總線適配卡的硬體裝置擴充功能指標， (HBA) 。

[in] ScatterGatherList

緩衝區的指標，其中包含先前由 StorPortBuildScatterGatherList 例程呼叫所建立的散佈/收集清單。

[in] WriteToDevice

值，表示已完成的 DMA 傳輸方向。 TRUE 值表示從數據緩衝區傳送到裝置，FALSE 表示從裝置傳輸到數據緩衝區。

傳回值

StorPortPutScatterGatherList 會傳回下列其中一個狀態代碼：

傳回碼 Description
STOR_STATUS_NOT_IMPLEMENTED
 此函式不會在作用中的操作系統上實作。
STOR_STATUS_SUCCESS
 表示例程已成功釋放散佈/收集清單。
STOR_STATUS_INVALID_PARAMETER
 傳遞的 HwDeviceExtension 為 NULL。
STOR_STATUS_INVALID_IRQL
 呼叫是在無效的 IRQL 進行。

備註

StorPortPutScatterGatherList 例程不會釋放散佈/收集清單的緩衝區內存，因為迷你埠驅動程式已配置此記憶體。

StorPortPutScatterGatherList 例程傳回之後，迷你埠驅動程式可以再次呼叫 StorPortBuildScatterGatherList 來重複使用緩衝區來建立新的散佈/收集清單。 如果迷你埠驅動程式已完成使用散佈/收集清單的緩衝區，它應該會在 StorPortPutScatterGatherList 例程傳回之後釋放緩衝區的記憶體。 如果迷你埠驅動程式使用 StorPortAllocatePool 例程配置緩衝區內存，它應該藉由呼叫 StorPortFreePool 例程來釋放記憶體。

規格需求

需求 值
目標平台 Universal
標頭 storport.h (包含 Storport.h)
IRQL DISPATCH_LEVEL
DDI 合規性規則 StorPortIrql (storport)

另請參閱

StorPortBuildScatterGatherList