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