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

Article
03/01/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 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 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 la valeur NULL si le pilote ne fournit pas de nom pour un magasin de propriétés d’appareil.

[in] Flags

Valeur de type WDF_PROPERTY_STORE_RETRIEVE_FLAGS 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 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 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

Voir aussi

IWDFDeviceInitialize

IWDFNamedPropertyStore

WDF_PROPERTY_STORE_DISPOSITION

WDF_PROPERTY_STORE_RETRIEVE_FLAGS

Partager via