WdfStringGetUnicodeString-Funktion (wdfstring.h)
[Gilt für KMDF und UMDF]
Die WdfStringGetUnicodeString-Methode ruft die Unicode-Zeichenfolge ab, die einem angegebenen Frameworkzeichenfolgenobjekt zugewiesen ist.
Syntax
void WdfStringGetUnicodeString(
[in] WDFSTRING String,
[out] PUNICODE_STRING UnicodeString
);
Parameter
[in] String
Ein Handle für ein Frameworkzeichenfolgenobjekt.
[out] UnicodeString
Ein Zeiger auf eine UNICODE_STRING-Struktur , die einen Zeiger auf die Unicode-Zeichenfolge empfängt, die derzeit dem von String angegebenen Zeichenfolgenobjekt zugewiesen ist.
Rückgabewert
Keine
Bemerkungen
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Nach der Rückgabe von WdfStringGetUnicodeString enthält die UNICODE_STRING Struktur, auf die UnicodeString zeigt, einen Zeiger auf die Unicode-Zeichenfolge des angegebenen Zeichenfolgenobjekts zusammen mit der Länge der Zeichenfolge. Die Unicode-Zeichenfolge wird im ausgelagerten Pool zugeordnet.
Das Framework macht keine Kopie der Zeichenfolge für den Treiber.
Weitere Informationen zu Framework-Zeichenfolgenobjekten finden Sie unter Verwenden von Zeichenfolgenobjekten.
Beispiele
Im folgenden Codebeispiel wird die Unicode-Zeichenfolge abgerufen, die einem angegebenen Frameworkzeichenfolgenobjekt zugewiesen ist.
UNICODE_STRING StringName;
WdfStringGetUnicodeString(
stringHandle,
&StringName
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfstring.h (include Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |