fonction CM_Get_Device_Interface_PropertyW (cfgmgr32.h)

Article
02/26/2024

La fonction CM_Get_Device_Interface_Property récupère une propriété d’appareil définie pour une interface d’appareil.

Syntaxe

CMAPI CONFIGRET CM_Get_Device_Interface_PropertyW(
  [in]      LPCWSTR          pszDeviceInterface,
  [in]      const DEVPROPKEY *PropertyKey,
  [out]     DEVPROPTYPE      *PropertyType,
  [out]     PBYTE            PropertyBuffer,
  [in, out] PULONG           PropertyBufferSize,
  [in]      ULONG            ulFlags
);

Paramètres

[in] pszDeviceInterface

Pointeur vers une chaîne qui identifie l’interface de l’appareil instance à partir de laquelle récupérer la propriété.

[in] PropertyKey

Pointeur vers une structure DEVPROPKEY qui représente la clé de propriété d’interface d’appareil de la propriété d’interface d’appareil à récupérer.

[out] PropertyType

Pointeur vers une variable de type DEVPROPTYPE qui reçoit l’identificateur de type property-data de la propriété d’interface d’appareil demandée. L’identificateur de type de données de propriété est un ou au niveau du bit entre un identificateur de type de données de base et, si le type de données de base est modifié, un modificateur de type de données de propriété.

[out] PropertyBuffer

Pointeur vers une mémoire tampon qui reçoit la propriété d’interface d’appareil demandée. CM_Get_Device_Interface_Property récupère la propriété demandée uniquement si la mémoire tampon est suffisamment grande pour contenir toutes les données de valeur de propriété. Le pointeur peut avoir la valeur NULL.

[in, out] PropertyBufferSize

Taille, en octets, de la mémoire tampon PropertyBuffer . Si PropertyBuffer a la valeur NULL, *PropertyBufferSize doit avoir la valeur zéro. En sortie, si la mémoire tampon n’est pas assez grande pour contenir toutes les données de valeur de propriété, CM_Get_Device_Interface_Property retourne la taille des données, en octets, dans *PropertyBufferSize.

[in] ulFlags

Réservé. Doit être défini sur zéro.

Valeur retournée

Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, il retourne l’un des codes d’erreur CR_ préfixés définis dans Cfgmgr32.h.

Remarques

CM_Get_Device_Interface_Property fait partie du modèle de propriété d’appareil unifié.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows Vista et les versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	cfgmgr32.h (inclure Cfgmgr32.h)
Bibliothèque	Cfgmgr32.lib

Voir aussi

SetupDiGetDeviceInterfaceProperty

Partager via