CM_Get_Class_PropertyW, fonction (cfgmgr32.h)

Article
02/23/2024

La fonction CM_Get_Class_Property récupère une propriété d’appareil définie pour une classe d’interface d’appareil ou une classe de configuration d’appareil.

Syntaxe

CMAPI CONFIGRET CM_Get_Class_PropertyW(
  [in]      LPCGUID          ClassGUID,
  [in]      const DEVPROPKEY *PropertyKey,
  [out]     DEVPROPTYPE      *PropertyType,
  [out]     PBYTE            PropertyBuffer,
  [in, out] PULONG           PropertyBufferSize,
  [in]      ULONG            ulFlags
);

Paramètres

[in] ClassGUID

Pointeur vers le GUID qui identifie la classe d’interface d’appareil ou la classe de configuration d’appareil pour laquelle récupérer une propriété d’appareil définie pour la classe d’appareil. Pour plus d’informations sur la spécification du type de classe, consultez le paramètre ulFlags .

[in] PropertyKey

Pointeur vers une structure DEVPROPKEY qui représente la clé de propriété de périphérique de la propriété de classe d’appareil demandée.

[out] PropertyType

Pointeur vers une variable de type DEVPROPTYPE qui reçoit l’identificateur property-data-type de la propriété de classe d’appareil demandée, où l’identificateur de type de données de propriété est le bit OR entre un identificateur de type de données de base et, si le type de données de base est modifié, un modificateur property-data-type.

[out] PropertyBuffer

Pointeur vers une mémoire tampon qui reçoit la propriété de classe d’appareil demandée. CM_Get_Class_Property récupère la valeur de 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 être NULL.

[in, out] PropertyBufferSize

Taille, en octets, de la mémoire tampon PropertyBuffer . Si le paramètre 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_Class_Property retourne la taille des données, en octets, dans *PropertyBufferSize.

[in] ulFlags

Indicateurs de propriété de classe :

CM_CLASS_PROPERTY_INSTALLER

ClassGUID spécifie une classe de configuration d’appareil. Ne combinez pas avec CM_CLASS_PROPERTY_INTERFACE.

CM_CLASS_PROPERTY_INTERFACE

ClassGUID spécifie une classe d’interface d’appareil. Ne combinez pas avec CM_CLASS_PROPERTY_INSTALLER.

Valeur retournée

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

Remarques

CM_Get_Class_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 versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	cfgmgr32.h (inclure Cfgmgr32.h)
Bibliothèque	Cfgmgr32.lib

Voir aussi

SetupDiGetClassProperty

Partager via