Funzione WdfStringGetUnicodeString (wdfstring.h)
[Si applica a KMDF e UMDF]
Il metodo WdfStringGetUnicodeString recupera la stringa Unicode assegnata a un oggetto stringa 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 String.
Valore restituito
Nessuno
Osservazioni
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Dopo aver restituito 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 Using String Objects.
Esempi
Nell'esempio di codice seguente viene ottenuta la stringa Unicode assegnata a un oggetto stringa framework specificato.
UNICODE_STRING StringName;
WdfStringGetUnicodeString(
stringHandle,
&StringName
);
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 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) |