NdisBuildScatterGatherList 函式 (ndis.h)

發行項
02/29/2024

NdisBuildScatterGatherList 函式會使用指定的參數來建置散佈/收集清單。

語法

NDIS_STATUS NdisBuildScatterGatherList(
  [in] IN NDIS_HANDLE                          NdisHandle,
  [in] IN PNDIS_SCATTER_GATHER_LIST_PARAMETERS SGListParameters
);

參數

[in] NdisHandle

在呼叫端初始化期間取得的 NDIS 驅動程式或實例句柄。例如，迷你埠驅動程式可以使用從取得的 NDIS 句柄 NdisMRegisterMiniportDriver 或 MiniportInitializeEx 函式。其他 NDIS 驅動程式可以使用下列函式中的句柄：

NdisRegisterProtocolDriver

NdisOpenAdapterEx

[in] SGListParameters

的指標 NDIS_SCATTER_GATHER_LIST_PARAMETERS 結構，指定配置散佈/收集清單的參數。

傳回值

NdisBuildScatterGatherList 可以傳回下列狀態值：

傳回碼	Description
NDIS_STATUS_SUCCESS	作業已成功完成。
NDIS_STATUS_BUFFER_TOO_SHORT	作業失敗，因為 ScatterGatherListBufferSize 成員中指定的緩衝區長度 NDIS_SCATTER_GATHER_LIST_PARAMETERS 結構太短。在此情況下，NDIS 在 ScatterGatherListBufferSizeNeeded 成員中提供了必要的緩衝區大小。

備註

NDIS 驅動程式會呼叫 NdisBuildScatterGatherList 函式來建置緩衝區的散佈/收集清單。若要呼叫此函式，迷你埠驅動程式會指定迷你埠配接器句柄，或通訊協定驅動程式指定 NDIS 系結句柄。

基礎迷你埠配接器必須已呼叫驅動程式可以呼叫 NdisBuildScatterGatherList 之前，NdisMRegisterScatterGatherDma。

NDIS 會呼叫在 ProcessSGListHandler 成員指定的 NetProcessSGListList 函式 NDIS_SCATTER_GATHER_LIST_PARAMETERSNdisBuildScatterGatherList 內容中的結構。

驅動程式必須呼叫 NdisFreeScatterGatherList 函式可釋出使用所建立的散佈/收集清單 NdisBuildScatterGatherList 函式。

規格需求

需求	值
最低支援的用戶端	NDIS 6.20 和更新版本支援。
目標平台	Universal
標頭	ndis.h (包含 Ndis.h)
程式庫	Ndis.lib
IRQL	= DISPATCH_LEVEL