Функция NdisInitializeString (ndis.h)

Статья
08/07/2023

Функция NdisInitializeString выделяет хранилище для и инициализирует подсчитываемую строку в системном наборе символов по умолчанию.

Синтаксис

void NdisInitializeString(
  PNDIS_STRING Destination,
  PUCHAR       Source
);

Параметры

Destination

Указатель на NDIS_STRING с буфером NULL . При возвращении из этой функции NDIS_STRING содержит инициализированную подсчитываемую строку. Для Windows 2000 и более поздних версий NDIS определяет тип NDIS_STRING как тип UNICODE_STRING .

Source

Указатель на строку, завершающуюся нулевым значением, с помощью которой инициализируется подсчитываемая строка. SourceString не должен иметь значение NULL.

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

None

Remarks

NdisInitializeString задает элементы Length и MaximumLength NDIS_STRING для конечной строки и завершает конечную строку нулевым значением. Для драйверов Windows 2000 и более поздних версий NdisInitializeString преобразует указанную исходную строку в символы Юникода.

SourceString не должен иметь значение NULL.

Буфер, выделенный NdisInitializeString , должен быть освобожден с помощью функции NdisFreeString .

Требования

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