Функция 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) |