Función WdfRegistryAssignValue (wdfregistry.h)

Artículo
03/22/2025

[Se aplica a KMDF y UMDF]

El método WdfRegistryAssignValue asigna datos especificados a un nombre de valor especificado en el Registro.

Sintaxis

NTSTATUS WdfRegistryAssignValue(
  [in] WDFKEY           Key,
  [in] PCUNICODE_STRING ValueName,
  [in] ULONG            ValueType,
  [in] ULONG            ValueLength,
  [in] PVOID            Value
);

Parámetros

[in] Key

Identificador de un objeto de clave del Registro que representa una clave del Registro abierta.

[in] ValueName

Puntero a una estructura UNICODE_STRING que contiene un nombre de valor.

[in] ValueType

Valor que identifica el tipo de datos. Para obtener una lista de valores de tipo de datos, vea el miembro type de de KEY_VALUE_BASIC_INFORMATION.

[in] ValueLength

Longitud, en bytes, del búfer al que valor apunta.

[in] Value

Puntero a un búfer que contiene datos proporcionados por el controlador.

Valor devuelto

WdfRegistryAssignValue 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 de retorno	Descripción
STATUS_INVALID_DEVICE_REQUEST	no se llamó a WdfRegistryAssignValue en IRQL = PASSIVE_LEVEL.
STATUS_INVALID_PARAMETER	Se especificó un parámetro no válido.
STATUS_ACCESS_DENIED	El controlador no abrió la clave del Registro con KEY_SET_VALUE acceso.

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.

Observaciones

Si el nombre del valor que el parámetro ValueName especifica ya existe, WdfRegistryAssignValue actualiza los datos del valor.

Para obtener más información sobre los objetos de clave del Registro, vea Using the Registry in Framework-Based Drivers.

Ejemplos

En el ejemplo de código siguiente se asigna 123456 hexadecimal a un valor del Registro como datos binarios.

ULONG val;
NTSTATUS status;

val = 0x123456;
status = WdfRegistryAssignValue(
                                Key,
                                &valueName,
                                REG_BINARY,
                                sizeof(val),
                                &val
                                );

Requisitos

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	wdfregistry.h (incluya Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)