Fungsi WdfStringGetUnicodeString (wdfstring.h)

[Berlaku untuk KMDF dan UMDF]

Metode WdfStringGetUnicodeString mengambil string Unicode yang ditetapkan ke objek string kerangka kerja tertentu.

Sintaksis

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

Parameter

[in] String

Handel ke objek string kerangka kerja.

[out] UnicodeString

Penunjuk ke struktur UNICODE_STRING yang menerima penunjuk ke string Unicode yang saat ini ditetapkan ke objek string yang string yang tentukan.

Mengembalikan nilai

Tidak

Komentar

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Setelah WdfStringGetUnicodeString kembali, struktur UNICODE_STRING yang UnicodeString menunjuk ke string Unicode objek string yang ditentukan, bersama dengan panjang string. String Unicode dialokasikan di kumpulan halaman.

Kerangka kerja tidak membuat salinan string untuk driver.

Untuk informasi selengkapnya tentang objek string kerangka kerja, lihat Menggunakan Objek String.

Contoh

Contoh kode berikut mendapatkan string Unicode yang ditetapkan ke objek string kerangka kerja tertentu.

UNICODE_STRING StringName;

WdfStringGetUnicodeString(
                          stringHandle,
                          &StringName
                          );

Persyaratan

Syarat	Nilai
Platform Target	Universal
versi KMDF Minimum	1.0
versi UMDF Minimum	2.0
Header	wdfstring.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
aturan kepatuhan DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

UNICODE_STRING

WdfStringBuat