NdisAllocateCloneNetBufferList 函数 (ndis/nblapi.h)

项目
03/05/2024

调用 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 及更高版本中受支持。
目标平台	通用
标头	ndis/nblapi.h (包括 ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 符合性规则	Irql_NetBuffer_Function (ndis) 、NdisAllocateCloneNetBufferList (ndis) 、NdisAllocateCloneNetBufferList_InitFail (ndis)