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

  • Статья

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

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

Синтаксис

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

Параметры

[in] String

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

[out] UnicodeString

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

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

None

Remarks

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

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

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

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

Примеры

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

UNICODE_STRING StringName;

WdfStringGetUnicodeString(
                          stringHandle,
                          &StringName
                          );

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfstring.h (включая Wdf.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

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

UNICODE_STRING

WdfStringCreate