IWDFDevice ::RetrieveDevicePropertyStore, méthode (wudfddi.h)

Article
02/07/2025

[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 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 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. Le pilote utilise cette interface pour accéder aux valeurs du Registre.

[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