Fungsi WdfStringGetUnicodeString (wdfstring.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

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

Sintaks

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 ditentukan String .

Nilai kembali

Tidak ada

Keterangan

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

Setelah WdfStringGetUnicodeString kembali, struktur UNICODE_STRING yang dituju UnicodeString berisi penunjuk 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

Persyaratan Nilai
Target Platform 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

WdfStringCreate