Método IWDFDevice::RetrieveDevicePropertyStore (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante 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 a 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 un cadena terminada en NULLque 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 con tipo WDF_PROPERTY_STORE_RETRIEVE_FLAGSque 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 con tipo WDF_PROPERTY_STORE_DISPOSITIONque 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.
Observaciones
El autor de la llamada debe llamar al método Release del IWDFNamedPropertyStore interfaz después de finalizar con el almacén de propiedades.
Para obtener más información, vea Using the Registry in UMDF-based Drivers.
Requisitos
Requisito | Valor |
---|---|
fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
de la plataforma de destino de | Escritorio |
versión mínima de UMDF | 1.5 |
encabezado de | wudfddi.h (incluya Wudfddi.h) |
DLL de | WUDFx.dll |
Consulte también
IWDFDeviceInitialize::RetrieveDevicePropertyStore
IWDFPropertyStoreFactory::RetrieveDevicePropertyStore