Поделиться через


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

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

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

ANSI_STRING

DriverEntry of NDIS Protocol Drivers

MiniportInitializeEx

NdisOpenAdapterEx

NdisRegisterProtocolDriver

ProtocolBindAdapterEx

RtlInitString

RtlInitUnicodeString

RtlUnicodeStringToAnsiString

UNICODE_STRING