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

Статья
08/07/2023

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

Синтаксис

void NdisFreeString(
  [in]  String
);

Параметры

[in] String

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

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

None

Remarks

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

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

Требования

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