共用方式為

WdfStringGetUnicodeString 函式 (wdfstring.h)

  • 發行項

[適用於 KMDF 和 UMDF]

WdfStringGetUnicodeString 方法會擷取指派給指定架構字串物件的 Unicode 字串串。

語法

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

參數

[in] String

架構字串物件的句柄。

[out] UnicodeString

UNICODE_STRING 結構的指標，接收目前指派給 String 指定之字串物件的 Unicode 字串指標。

傳回值

無

備註

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

WdfStringGetUnicodeString 傳回之後，UnicodeString 指向的UNICODE_STRING結構會包含指定字串物件的 Unicode 字串指標，以及字符串的長度。 Unicode 字串會配置在分頁集區中。

架構不會為驅動程式建立字串複本。

如需架構字串物件的詳細資訊，請參閱 使用字串物件。

範例

下列程式代碼範例會取得指派給指定架構字串物件的 Unicode 字串。

UNICODE_STRING StringName;

WdfStringGetUnicodeString(
                          stringHandle,
                          &StringName
                          );

規格需求

需求 值
目標平台 Universal
最低 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