Méthode IWDFDevice ::RetrieveDevicePropertyStore (wudfddi.h)

Article
03/05/2024

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode RetrieveDevicePropertyStore récupère une interface de magasin de propriétés que les pilotes peuvent utiliser pour accéder au Registre.

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 terminée par NULL qui représente le nom du magasin de propriétés d’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 de périphérique.

[in] Flags

Valeur WDF_PROPERTY_STORE_RETRIEVE_FLAGS typée qui identifie comment récupérer le magasin de propriétés d’appareil.

[out] ppPropStore

Pointeur vers une mémoire tampon qui reçoit un pointeur vers l’interface IWDFNamedPropertyStore . Le pilote utilise cette interface pour accéder aux valeurs dans le Registre.

[out, optional] pDisposition

Pointeur vers une variable qui reçoit une valeur de type WDF_PROPERTY_STORE_DISPOSITION qui identifie si l’infrastructure a créé le magasin de propriétés d’appareil ou si le magasin de propriétés d’appareil existait déjà. Ce paramètre est facultatif. Le pilote peut passer la valeur NULL si le pilote n’a pas besoin des informations de disposition.

Valeur retournée

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 une fois le magasin de propriétés terminé.

Pour plus d’informations, consultez Utilisation du Registre dans les pilotes basés sur UMDF.

Configuration requise

Condition requise	Valeur
Fin de la prise en charge	Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
Version UMDF minimale	1.5
En-tête	wudfddi.h (inclure Wudfddi.h)
DLL	WUDFx.dll