NdisAllocateCloneNetBufferList 函式 (ndis/nblapi.h)
呼叫 NdisAllocateCloneNetBufferList 函式，以建立新的複製 NET_BUFFER_LIST 結構。
語法
NDIS_EXPORTED_ROUTINE NET_BUFFER_LIST * NdisAllocateCloneNetBufferList(
[in] NET_BUFFER_LIST *OriginalNetBufferList,
[in, optional] NDIS_HANDLE NetBufferListPoolHandle,
[in, optional] NDIS_HANDLE NetBufferPoolHandle,
[in] ULONG AllocateCloneFlags
);
參數
[in] OriginalNetBufferList
現有 NET_BUFFER_LIST 結構的指標。
[in, optional] NetBufferListPoolHandle
從呼叫取得的句柄 NdisAllocateNetBufferListPool 函式。
[in, optional] NetBufferPoolHandle
先前從呼叫傳回的 NET_BUFFER 結構集區句柄 NdisAllocateNetBufferPool。
[in] AllocateCloneFlags
可與 OR 作業結合的 NDIS 旗標。 定義下列旗標：
NDIS_CLONE_FLAGS_RESERVED
保留給 NDIS。
NDIS_CLONE_FLAGS_USE_ORIGINAL_MDLS
如果設定此旗標，NDIS 不會為複製 的NET_BUFFER_LIST配置新的 MDL。 相反地，複製 的NET_BUFFER_LIST 會使用與原始 NET_BUFFER_LIST相同的 MDL 鏈結。 如果清除NDIS_CLONE_FLAGS_USE_ORIGINAL_MDLS，NDIS 會配置新的 MDL 來參考原始數據緩衝區。
傳回值
NdisAllocateCloneNetBufferList 會傳回新複製 NET_BUFFER_LIST 結構的指標。 如果配置失敗，則此指標為 NULL。
備註
呼叫 NdisAllocateCloneNetBufferList 來建立複製 NET_BUFFER_LIST 結構，讓您可用來在個別的數據路徑上傳送重複的數據。
原始NET_BUFFER_LIST結構中的每個NET_BUFFER結構只會從使用的數據空間開頭複製，而不是整個數據空間的開頭。 若要從數據空間的開頭到已使用之數據空間的開頭取得位移，請使用 NET_BUFFER_DATA_OFFSET 宏。
如果複製的NET_BUFFER_LIST結構應該具有與指定集區相關聯的屬性，呼叫端必須在 NetBufferListPoolHandle 或 NetBufferPoolHandle 參數中指定集區句柄。 例如，NET_BUFFER_LIST 結構的 ProtocolType 成員與集區相關聯。
複製NET_BUFFER_LIST結構描述在 OriginalNetBufferList 上NET_BUFFER_LIST結構所描述的相同數據。 NDIS 不會將原始 MDL 所描述的數據複製到新的數據緩衝區。 相反地，複製的結構會參考原始數據緩衝區。 複製 NET_BUFFER_LIST 結構不包含初始 NET_BUFFER_LIST_CONTEXT 結構。
呼叫 NdisFreeCloneNetBufferList 函式可釋放 NET_BUFFER_LIST 結構，以及呼叫 NdisAllocateCloneNetBufferList 所配置的所有相關聯結構和 MDL 鏈結。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
| 目標平台 | Universal |
| 標頭 | ndis/nblapi.h (include ndis.h) |
| 程式庫 | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | Irql_NetBuffer_Function (ndis) 、NdisAllocateCloneNetBufferList (ndis) ，NdisAllocateCloneNetBufferList_InitFail (ndis) |