Condividi tramite


Metodo IWDFDeviceInitialize::RetrieveDevicePropertyStore (wudfddi.h)

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]

Il metodo RetrieveDevicePropertyStore recupera un archivio delle proprietà del dispositivo che i client possono leggere e scrivere le proprietà del dispositivo.

Sintassi

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

Parametri

[in, optional] pcwszServiceName

Puntatore a un NULLstringa con terminazione che rappresenta il nome dell'archivio delle proprietà del dispositivo. Questo parametro è facoltativo. Il driver può passare NULL se il driver non fornisce un nome per un archivio delle proprietà del dispositivo.

[in] Flags

Valore WDF_PROPERTY_STORE_RETRIEVE_FLAGStipizzato che identifica come recuperare l'archivio delle proprietà del dispositivo.

[out] ppPropStore

Puntatore a un buffer che riceve un puntatore all'interfaccia IWDFNamedPropertyStore usata per recuperare le proprietà del dispositivo.

[out, optional] pDisposition

Puntatore a una variabile che riceve un valore di tipo WDF_PROPERTY_STORE_DISPOSITIONche identifica se il framework ha creato l'archivio delle proprietà del dispositivo o l'archivio delle proprietà del dispositivo già esistente. Questo parametro è facoltativo. Il driver può passare NULL se il driver non richiede le informazioni sull'eliminazione.

Valore restituito

RetrieveDevicePropertyStore restituisce S_OK se l'operazione ha esito positivo. In caso contrario, questo metodo restituisce uno dei codici di errore definiti in Winerror.h.

Osservazioni

Il chiamante deve chiamare il metodo release dell'interfaccia IWDFNamedPropertyStore dopo aver completato l'archivio delle proprietà.

Per altre informazioni, vedere Uso del Registro di sistema nei driver basati su UMDF.

Fabbisogno

Requisito Valore
Fine del supporto Non disponibile in UMDF 2.0 e versioni successive.
piattaforma di destinazione Desktop
versione minima di UMDF 1.5
intestazione wudfddi.h (include Wudfddi.h)
dll WUDFx.dll

Vedere anche

IWDFDeviceInitialize

IWDFNamedPropertyStore

WDF_PROPERTY_STORE_DISPOSITION

WDF_PROPERTY_STORE_RETRIEVE_FLAGS