Función WdfRegistryQueryUnicodeString (wdfregistry.h)
[Se aplica a KMDF y UMDF]
El método WdfRegistryQueryUnicodeString recupera los datos de cadena asignados actualmente a un valor de cadena del Registro especificado y copia la cadena en una estructura de UNICODE_STRING especificada.
NTSTATUS WdfRegistryQueryUnicodeString(
[in] WDFKEY Key,
[in] PCUNICODE_STRING ValueName,
[out, optional] PUSHORT ValueByteLength,
[in, out] PUNICODE_STRING Value
);
[in] Key
Identificador de un objeto de clave del Registro que representa una clave del Registro abierta.
[in] ValueName
Puntero a una estructura de UNICODE_STRING que contiene un nombre para el valor del Registro.
[out, optional] ValueByteLength
Puntero a una ubicación que recibe el número de bytes contenidos en la cadena Unicode a la que apunta Value, incluida la terminación null byte. Este puntero es opcional y puede ser NULL
[in, out] Value
Puntero a una estructura de UNICODE_STRING que recibe la cadena de datos de la clave que key especifica. Si este parámetro es NULL y ValueByteLength no esNULL, WdfRegistryQueryUnicodeString devuelve solo el tamaño de la cadena.
WdfRegistryQueryUnicodeString devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, el método podría devolver uno de los siguientes valores:
Código devuelto | Descripción |
---|---|
|
no se llamó a WdfRegistryQueryUnicodeString en IRQL = PASSIVE_LEVEL. |
|
Se especificó un parámetro no válido. |
|
No había memoria suficiente para completar la operación. |
|
El controlador no abrió la clave del Registro con acceso KEY_QUERY_VALUE, KEY_READ o KEY_ALL_ACCESS. |
|
El tipo de datos del valor del Registro que el parámetro ValueName especificado no se REG_SZ. |
|
El búfer al que apunta el Valor era demasiado pequeño y solo se escribieron datos parciales en el búfer. |
|
El búfer al que apunta el valor era demasiado pequeño y no se escribió ningún dato en el búfer. |
|
El valor del Registro no estaba disponible. |
Este método también puede devolver otros valores de NTSTATUS.
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Para obtener más información sobre los objetos de clave del Registro, vea Using the Registry in Framework-Based Drivers.
En el ejemplo de código siguiente, que procede del controlador de ejemplo serie de, se recupera la cadena Unicode que representa los datos de cadena asignados al valor portName en la clave de hardware de un dispositivo.
NTSTATUS
SerialReadSymName(
IN WDFDEVICE Device,
__out PWCHAR RegName,
IN OUT PUSHORT LengthOfRegName // In characters
)
{
NTSTATUS status;
WDFKEY hKey;
UNICODE_STRING value;
UNICODE_STRING valueName;
USHORT requiredLength;
value.Buffer = RegName;
value.MaximumLength = *LengthOfRegName;
value.Length = 0;
status = WdfDeviceOpenRegistryKey(
Device,
PLUGPLAY_REGKEY_DEVICE,
STANDARD_RIGHTS_ALL,
WDF_NO_OBJECT_ATTRIBUTES,
&hKey
);
if (NT_SUCCESS (status)) {
RtlInitUnicodeString(
&valueName,
L"PortName"
);
status = WdfRegistryQueryUnicodeString (
hKey,
&valueName,
&requiredLength,
&value
);
WdfRegistryClose(hKey);
}
return status;
}
Requisito | Valor |
---|---|
de la plataforma de destino de | Universal |
versión mínima de KMDF | 1.0 |
versión mínima de UMDF | 2.0 |
encabezado de | wdfregistry.h (incluya Wdf.h) |
biblioteca de | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
irQL | PASSIVE_LEVEL |
reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |