Макрос NdisFreeString (ndis.h)

Статья
02/07/2025

Функция NdisFreeString освобождает хранилище, выделенное NdisInitializeString для буферизованной строки.

Синтаксис

void NdisFreeString(
  [in]  String
);

Параметры

[in] String

Значение типа NDIS_STRING, описывающее строку для освобождения. Для Windows 2000 и более поздних версий NDIS определяет тип NDIS_STRING как тип UNICODE_STRING.

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

Никакой

Замечания

Драйвер NDIS обычно вызывает функцию NdisInitializeStr ing во время инициализации, например, чтобы настроить имена, передаваемые в функции NdisXxxConfiguration. Для каждого вызова, который выполняет драйвер для NdisInitializeString, драйвер должен выполнить соответствующий вызов NdisFreeString. При освобождении строковых буферов, выделенных во время инициализации, драйвер должен вызывать NdisFreeString, прежде чем функция инициализации драйвера возвращает элемент управления.

NdisFreeString необходимо использовать только для освобождения буферов, выделенных с NdisInitializeString.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается для существующих драйверов в NDIS 6.0 и более поздних версиях, но новые драйверы должны использовать RtlFreeAnsiString или RtlFreeUnicodeString вместо этого.
целевая платформа	Настольный
заголовка	ndis.h (include Ndis.h)
IRQL	PASSIVE_LEVEL
правил соответствия DDI	Irql_Miscellaneous_Function(ndis)