Функция WdfStringGetUnicodeString (wdfstring.h)

Статья
02/07/2025

[Применимо к KMDF и UMDF]

Метод WdfStringGetUnicodeString извлекает строку Юникода, назначенную указанному объекту строки платформы.

Синтаксис

void WdfStringGetUnicodeString(
  [in]  WDFSTRING       String,
  [out] PUNICODE_STRING UnicodeString
);

Параметры

[in] String

Дескриптор объекта строки платформы.

[out] UnicodeString

Указатель на структуру UNICODE_STRING, которая получает указатель на строку Юникода, которая в настоящее время назначается строковому объекту, который String указывает.

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

Никакой

Замечания

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

После WdfStringGetUnicodeString возвращается структура UNICODE_STRING, которая ЮникодСтринг указывает на указатель на строку Юникода указанного объекта строки, а также длину строки. Строка Юникода выделяется в пуле страниц.

Платформа не делает копию строки для драйвера.

Дополнительные сведения о строковых объектах платформы см. в разделе Использование строковых объектов.

Примеры

В следующем примере кода получается строка Юникода, назначенная указанному объекту строки платформы.

UNICODE_STRING StringName;

WdfStringGetUnicodeString(
                          stringHandle,
                          &StringName
                          );

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	wdfstring.h (include Wdf.h)
библиотеки	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

UNICODE_STRING

WdfStringCreate

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