Función WdfStringGetUnicodeString (wdfstring.h)
[Se aplica a KMDF y UMDF]
El método WdfStringGetUnicodeString recupera la cadena Unicode asignada a un objeto de cadena de marco especificado.
Sintaxis
void WdfStringGetUnicodeString(
[in] WDFSTRING String,
[out] PUNICODE_STRING UnicodeString
);
Parámetros
[in] String
Identificador de un objeto de cadena de marco.
[out] UnicodeString
Puntero a una estructura de UNICODE_STRING que recibe un puntero a la cadena Unicode que está asignada actualmente al objeto de cadena que string especifica.
Valor devuelto
None
Observaciones
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Después de que WdfStringGetUnicodeString devuelva, la estructura UNICODE_STRING que UnicodeString apunta a contiene un puntero a la cadena Unicode del objeto de cadena especificado, junto con la longitud de la cadena. La cadena Unicode se asigna en el grupo paginado.
El marco no realiza una copia de la cadena para el controlador.
Para obtener más información sobre los objetos de cadena de marco, vea Uso de objetos de cadena.
Ejemplos
En el ejemplo de código siguiente se obtiene la cadena Unicode asignada a un objeto de cadena de marco especificado.
UNICODE_STRING StringName;
WdfStringGetUnicodeString(
stringHandle,
&StringName
);
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfstring.h (incluir Wdf.h) |
| Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |