Método IWDFDevice::RetrieveDevicePropertyStore (wudfddi.h)

Artículo
08/08/2023

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

El método RetrieveDevicePropertyStore recupera una interfaz de almacén de propiedades que los controladores pueden usar para acceder al registro.

Sintaxis

HRESULT RetrieveDevicePropertyStore(
  [in, optional]  PCWSTR                            pcwszServiceName,
  [in]            WDF_PROPERTY_STORE_RETRIEVE_FLAGS Flags,
  [out]           IWDFNamedPropertyStore            **ppPropStore,
  [out, optional] WDF_PROPERTY_STORE_DISPOSITION    *pDisposition
);

Parámetros

[in, optional] pcwszServiceName

Puntero a una cadena terminada en NULL que representa el nombre del almacén de propiedades del dispositivo. Este parámetro es opcional. El controlador puede pasar NULL si el controlador no proporciona un nombre para un almacén de propiedades de dispositivo.

[in] Flags

Valor de tipo WDF_PROPERTY_STORE_RETRIEVE_FLAGS que identifica cómo recuperar el almacén de propiedades del dispositivo.

[out] ppPropStore

Puntero a un búfer que recibe un puntero a la interfaz IWDFNamedPropertyStore . El controlador usa esta interfaz para acceder a los valores del Registro.

[out, optional] pDisposition

Puntero a una variable que recibe un valor de tipo WDF_PROPERTY_STORE_DISPOSITION que identifica si el marco creó el almacén de propiedades del dispositivo o el almacén de propiedades del dispositivo ya existía. Este parámetro es opcional. El controlador puede pasar NULL si el controlador no requiere la información de eliminación.

Valor devuelto

RetrieveDevicePropertyStore devuelve S_OK si la operación se realiza correctamente. De lo contrario, este método devuelve uno de los códigos de error definidos en Winerror.h.

Comentarios

El llamador debe llamar al método Release de la interfaz IWDFNamedPropertyStore después de finalizar con el almacén de propiedades.

Para obtener más información, consulte Uso del Registro en controladores basados en UMDF.

Requisitos

Requisito	Value
Finalización del soporte técnico	No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino	Escritorio
Versión mínima de UMDF	1.5
Encabezado	wudfddi.h (incluya Wudfddi.h)
Archivo DLL	WUDFx.dll