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

  • Статья

Вызовите функцию NdisAdvanceNetBufferListDataStart , чтобы освободить пространство данных, которое было заявлено в предыдущих вызовахФункция NdisRetreatNetBufferListDataStart.

Синтаксис

NDIS_EXPORTED_ROUTINE VOID NdisAdvanceNetBufferListDataStart(
  [in] NET_BUFFER_LIST     *NetBufferList,
  [in] ULONG               DataOffsetDelta,
  [in] BOOLEAN             FreeMdl,
       NET_BUFFER_FREE_MDL *FreeMdlMdlHandler
);

Параметры

[in] NetBufferList

Указатель на ранее выделенную NET_BUFFER_LIST структуру.

[in] DataOffsetDelta

Объем используемого пространства данных для освобождения.

[in] FreeMdl

Если выделенная память TRUE и NDIS соответствует соответствующему вызову NdisRetreatNetBufferListDataStart , эта функция освобождает выделенную память и связанный MDL.

FreeMdlMdlHandler

Необязательная точка входа для функции NetFreeMdl . Если вызывающий объект указывает точку входа для функции NetFreeMdl , NDIS вызывает NetFreeMdl для освобождения MDL и памяти.

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

None

Remarks

Выпуски NdisAdvanceNetBufferListDataStartиспользовали пространство данных для всех NET_BUFFER структур в NET_BUFFER_LIST структуре. Если FreeMdl имеет значение TRUE и NdisRetreatNetBufferListDataStart , выделенная память для удовлетворения соответствующего запроса на выделение.
NdisAdvanceNetBufferListDataStart освобождает выделенную память. Вызов этой функции эквивалентен вызову NdisAdvanceNetBufferDataStart для каждой структуры NET_BUFFER в структуре NET_BUFFER_LIST. Однако более эффективным является вызов NdisAdvanceNetBufferListDataStart .

Когда драйверы протокола вызывают NdisAdvanceNetBufferListDataStart по пути получения для доступа к различным заголовкам транспорта, цепочку MDL не следует изменять, а FreeMdl имеет значение FALSE.

Требования

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

См. также раздел

NET_BUFFER

NET_BUFFER_LIST

NdisAdvanceNetBufferDataStart NdisRetreatNetBufferListDataStart

NetAllocateMdl

NetFreeMdl