WdfStringGetUnicodeString-Funktion (wdfstring.h)

  • Artikel

[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)

Weitere Informationen

UNICODE_STRING

WdfStringErstellen