Fungsi WdfStringGetUnicodeString (wdfstring.h)
[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) |