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 |