Partager via


fonction CM_Set_Device_Interface_PropertyW (cfgmgr32.h)

La fonction CM_Set_Device_Interface_Property définit une propriété d’appareil d’une interface d’appareil.

Syntaxe

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

Paramètres

[in] pszDeviceInterface

Pointeur vers une chaîne qui identifie l’interface d’appareil instance pour laquelle définir une propriété.

[in] PropertyKey

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

[in] PropertyType

Valeur de type DEVPROPTYPE qui représente l’identificateur de type de données de propriété pour la propriété d’interface de l’appareil. Pour supprimer une propriété, elle doit être définie sur DEVPROP_TYPE_EMPTY.

[in] PropertyBuffer

Pointeur vers une mémoire tampon qui contient la valeur de propriété de la propriété d’interface de l’appareil. Si la propriété ou les données sont supprimées, ce pointeur doit avoir la valeur NULL et PropertyBufferSize doit avoir la valeur zéro.

[in] PropertyBufferSize

Taille, en octets, de la mémoire tampon PropertyBuffer . Si PropertyBuffer a la valeur NULL, PropertyBufferSize doit avoir la valeur zéro.

[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_Set_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

SetupDiSetDeviceInterfaceProperty