Compartir a través de


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

[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 un almacén de propiedades de dispositivo mediante el que los clientes pueden leer y escribir propiedades de dispositivo.

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 WDF_PROPERTY_STORE_RETRIEVE_FLAGS con tipo 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 que se usa para recuperar las propiedades del dispositivo.

[out, optional] pDisposition

Puntero a una variable que recibe un valor con 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ían. 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

Consulte también

IWDFDeviceInitialize

IWDFNamedPropertyStore

WDF_PROPERTY_STORE_DISPOSITION

WDF_PROPERTY_STORE_RETRIEVE_FLAGS