CM_Get_DevNode_PropertyW, fonction (cfgmgr32.h)

La fonction CM_Get_DevNode_Property récupère une propriété d’appareil instance.

Syntaxe

CMAPI CONFIGRET CM_Get_DevNode_PropertyW(
  [in]      DEVINST          dnDevInst,
  [in]      const DEVPROPKEY *PropertyKey,
  [out]     DEVPROPTYPE      *PropertyType,
  [out]     PBYTE            PropertyBuffer,
  [in, out] PULONG           PropertyBufferSize,
  [in]      ULONG            ulFlags
);

Paramètres

[in] dnDevInst

Le instance de périphérique lié à l’ordinateur local.

[in] PropertyKey

Pointeur vers une structure DEVPROPKEY qui représente la clé de propriété de l’appareil demandé instance propriété.

[out] PropertyType

Pointeur vers une variable de type DEVPROPTYPE qui reçoit l’identificateur de type propriété-données de la propriété instance de l’appareil demandé, 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 instance d’appareil demandée. CM_Get_DevNode_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 être 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_DevNode_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, elle retourne l’un des codes d’erreur préfixés CR_ définis dans Cfgmgr32.h.

Remarques

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

Configuration requise

Voir aussi

SetupDiGetDeviceProperty