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)

Consulte también

UNICODE_STRING

WdfStringCreate