Funzione WdfStringGetUnicodeString (wdfstring.h)

  • Articolo

[Si applica a KMDF e UMDF]

Il metodo WdfStringGetUnicodeString recupera la stringa Unicode assegnata a un oggetto stringa di framework specificato.

Sintassi

void WdfStringGetUnicodeString(
  [in]  WDFSTRING       String,
  [out] PUNICODE_STRING UnicodeString
);

Parametri

[in] String

Handle per un oggetto stringa del framework.

[out] UnicodeString

Puntatore a una struttura UNICODE_STRING che riceve un puntatore alla stringa Unicode attualmente assegnata all'oggetto stringa specificato da String .

Valore restituito

nessuno

Osservazioni

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Dopo la restituzione di WdfStringGetUnicodeString , la struttura UNICODE_STRING che UnicodeString punta a contiene un puntatore alla stringa Unicode dell'oggetto stringa specificato, insieme alla lunghezza della stringa. La stringa Unicode viene allocata nel pool di paging.

Il framework non crea una copia della stringa per il driver.

Per altre informazioni sugli oggetti stringa del framework, vedere Uso di oggetti stringa.

Esempio

Nell'esempio di codice seguente viene ottenuta la stringa Unicode assegnata a un oggetto stringa di framework specificato.

UNICODE_STRING StringName;

WdfStringGetUnicodeString(
                          stringHandle,
                          &StringName
                          );

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione wdfstring.h (include Wdf.h)
Libreria Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

UNICODE_STRING

WdfStringCreate