Función WdfDeviceOpenDevicemapKey (wdfdevice.h)

[Se aplica a KMDF y UMDF]

El método WdfDeviceOpenDevicemapKey abre la clave DEVICEMAP y crea un objeto de clave del Registro de marco que representa la clave del Registro.

Sintaxis

NTSTATUS WdfDeviceOpenDevicemapKey(
  [in]           WDFDEVICE              Device,
  [in]           PCUNICODE_STRING       KeyName,
  [in]           ACCESS_MASK            DesiredAccess,
  [in, optional] PWDF_OBJECT_ATTRIBUTES KeyAttributes,
  [out]          WDFKEY                 *Key
);

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

[in] KeyName

Puntero a una estructura de UNICODE_STRING que especifica el nombre de la subclave que se va a abrir en DEVICEMAP.

[in] DesiredAccess

Valor de tipo ACCESS_MASKque especifica los derechos de acceso que solicita el controlador para la clave del Registro especificada.

Normalmente, un controlador KMDF solicita KEY_READ, KEY_WRITEo KEY_READ | KEY_WRITE.

Normalmente, un controlador UMDF solicita KEY_READ o KEY_SET_VALUE.

[in, optional] KeyAttributes

Puntero a una estructura de WDF_OBJECT_ATTRIBUTES que contiene atributos proporcionados por el controlador para el nuevo objeto de clave del Registro. Este parámetro es opcional y se puede WDF_NO_OBJECT_ATTRIBUTES.

[out] Key

Puntero a una ubicación que recibe un identificador del nuevo objeto de clave del Registro. El

Valor devuelto

WdfDeviceOpenDevicemapKey devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, el método podría devolver uno de los siguientes valores:

Para obtener una lista de otros valores devueltos que el método WdfDeviceOpenDevicemapKey podría devolver, vea Framework Object Creation Errors.

El método podría devolver otros valores ntstatus de .

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Observaciones

El registro contiene una clave HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP que usan algunos controladores para tecnologías anteriores, como puertos serie y paralelo. Si el controlador admite una tecnología que usa la clave DEVICEMAP, el controlador puede acceder a subclaves y valores bajo la clave llamando a WdfDeviceOpenDevicemapKey.

WdfDeviceOpenDevicemapKey devuelve una clave de volátil. Esto significa que la información no se conserva cuando se descarga el subárbol del Registro correspondiente.

Cuando el controlador haya terminado de usar la clave del Registro que abrió con WdfDeviceOpenDevicemapKey, el controlador debe llamar a WdfRegistryClose.

Para obtener más información sobre el registro, las claves de hardware y software y los objetos del Registro, consulte Using the Registry in Framework-Based Drivers.

Requisitos

Consulte también

WdfDeviceOpenRegistryKey

WdfFdoInitOpenRegistryKey