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

Требования

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

UNICODE_STRING

WdfStringCreate