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

Статья
02/07/2025

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

Синтаксис

void NdisInitializeString(
  PNDIS_STRING Destination,
  PUCHAR       Source
);

Параметры

Destination

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

Source

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

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

Никакой

Замечания

NdisInitializeString задает длину и членов 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 (include Ndis.h)
библиотеки	Ndis.lib
IRQL	PASSIVE_LEVEL
правил соответствия DDI	Irql_Miscellaneous_Function(ndis)