IWDFDeviceInitialize ::RetrieveDevicePropertyStore, méthode (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]
La méthode RetrieveDevicePropertyStore récupère un magasin de propriétés d’appareil via lequel les clients peuvent lire et écrire des propriétés d’appareil.
Syntaxe
HRESULT RetrieveDevicePropertyStore(
[in, optional] PCWSTR pcwszServiceName,
[in] WDF_PROPERTY_STORE_RETRIEVE_FLAGS Flags,
[out] IWDFNamedPropertyStore **ppPropStore,
[out, optional] WDF_PROPERTY_STORE_DISPOSITION *pDisposition
);
Paramètres
[in, optional] pcwszServiceName
Pointeur vers une chaîne NULL-terminated qui représente le nom du magasin de propriétés de l’appareil. Ce paramètre est facultatif. Le pilote peut passer NULL si le pilote ne fournit pas de nom pour un magasin de propriétés d’appareil.
[in] Flags
Valeur WDF_PROPERTY_STORE_RETRIEVE_FLAGS-typée qui identifie comment récupérer le magasin de propriétés de l’appareil.
[out] ppPropStore
Pointeur vers une mémoire tampon qui reçoit un pointeur vers l’interface IWDFNamedPropertyStore utilisée pour récupérer les propriétés de l’appareil.
[out, optional] pDisposition
Pointeur vers une variable qui reçoit une valeur WDF_PROPERTY_STORE_DISPOSITION-typée qui identifie si l’infrastructure a créé le magasin de propriétés de l’appareil ou le magasin de propriétés de l’appareil existait déjà. Ce paramètre est facultatif. Le pilote peut passer NULL si le pilote n’a pas besoin des informations de destruction.
Valeur de retour
RetrieveDevicePropertyStore retourne S_OK si l’opération réussit. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h.
Remarques
L’appelant doit appeler la méthode Release de l’interface IWDFNamedPropertyStore après avoir terminé avec le magasin de propriétés.
Pour plus d’informations, consultez Utilisation du Registre dans les pilotes basés sur UMDF.
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.5 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |