Функция NdisAllocateCloneNetBufferList (ndis/nblapi.h)

Статья
08/07/2023

Вызовите функцию 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

Флаги NDIS, которые можно объединить с операцией OR. Определены следующие флаги:

NDIS_CLONE_FLAGS_RESERVED

Зарезервировано для NDIS.

NDIS_CLONE_FLAGS_USE_ORIGINAL_MDLS

Если этот флаг установлен, NDIS не выделяет новые многомерные библиотеки для клонированных NET_BUFFER_LIST. Вместо этого клонированные NET_BUFFER_LIST используют ту же цепочку MDL, что и исходная NET_BUFFER_LIST. Если NDIS_CLONE_FLAGS_USE_ORIGINAL_MDLS очищается, NDIS выделяет новые многомерные библиотеки для ссылки на исходные буферы данных.

Возвращаемое значение

NdisAllocateCloneNetBufferList возвращает указатель на новую структуру NET_BUFFER_LIST клона. Если выделение не удалось выполнить, этот указатель имеет значение NULL.

Вызовите NdisAllocateCloneNetBufferList , чтобы создать структуру клонирования NET_BUFFER_LIST , которую можно использовать для отправки повторяющихся данных по отдельному пути к данным.

Каждая структура NET_BUFFER в исходной структуре NET_BUFFER_LIST клонируется только с начала используемого пространства данных, а не с начала всего пространства данных. Чтобы получить смещение от начала пространства данных до начала используемого пространства данных, используйте макрос NET_BUFFER_DATA_OFFSET .

Если клонированная структура NET_BUFFER_LIST должна иметь атрибуты, связанные с заданным пулом, вызывающий объект должен указать дескриптор пула в параметре NetBufferListPoolHandle или NetBufferPoolHandle . Например, член ProtocolTypeструктуры NET_BUFFER_LIST связан с пулом.

Структура клонирования NET_BUFFER_LIST описывает те же данные, которые описаны в структуре NET_BUFFER_LIST в OriginalNetBufferList. NDIS не копирует данные, описанные в исходных многомерных библиотеках, в новые буферы данных. Вместо этого клонированные структуры ссылаются на исходные буферы данных. Структура NET_BUFFER_LIST клонирования не включает начальную структуру NET_BUFFER_LIST_CONTEXT структура.

ВызовитеФункция NdisFreeCloneNetBufferList для освобождения структуры NET_BUFFER_LIST и всех связанных структур и цепочек MDL, выделенных путем вызова NdisAllocateCloneNetBufferList.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.0 и более поздних версиях.
Целевая платформа	Универсальное
Верхняя часть	ndis/nblapi.h (включая ndis.h)
Библиотека	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	Irql_NetBuffer_Function(ndis), NdisAllocateCloneNetBufferList(ndis), NdisAllocateCloneNetBufferList_InitFail(ndis)