WdfStringGetUnicodeString-Funktion (wdfstring.h)
[Gilt für KMDF und UMDF]
Die WdfStringGetUnicodeString- -Methode ruft die Unicode-Zeichenfolge ab, die einem angegebenen Framework-Zeichenfolgenobjekt zugewiesen ist.
Syntax
void WdfStringGetUnicodeString(
[in] WDFSTRING String,
[out] PUNICODE_STRING UnicodeString
);
Parameter
[in] String
Ein Handle zu einem Framework-Zeichenfolgenobjekt.
[out] UnicodeString
Ein Zeiger auf eine UNICODE_STRING-Struktur, die einen Zeiger auf die Unicode-Zeichenfolge empfängt, die derzeit dem Zeichenfolgenobjekt zugewiesen ist, das String angibt.
Rückgabewert
Nichts
Bemerkungen
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Nachdem WdfStringGetUnicodeString zurückgegeben wurde, wird die UNICODE_STRING Struktur, die UnicodeString verweist, auf einen Zeiger auf die Unicode-Zeichenfolge des angegebenen Zeichenfolgenobjekts sowie die Länge der Zeichenfolge verweisen. Die Unicode-Zeichenfolge wird im seitenseitigen Pool zugewiesen.
Das Framework erstellt keine Kopie der Zeichenfolge für den Treiber.
Weitere Informationen zu Framework-Zeichenfolgenobjekten finden Sie unter Verwenden von Zeichenfolgenobjekten.
Beispiele
Das folgende Codebeispiel ruft die Unicode-Zeichenfolge ab, die einem angegebenen Framework-Zeichenfolgenobjekt zugewiesen ist.
UNICODE_STRING StringName;
WdfStringGetUnicodeString(
stringHandle,
&StringName
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfstring.h (include Wdf.h) |
| Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL- | PASSIVE_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |