Fonction SetupDiSetDeviceInterfaceDefault (setupapi.h)

La fonction SetupDiSetDeviceInterfaceDefault définit une interface d’appareil comme interface par défaut pour une classe d’interface d’appareil.

Syntaxe

WINSETUPAPI BOOL SetupDiSetDeviceInterfaceDefault(
  [in]      HDEVINFO                  DeviceInfoSet,
  [in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
  [in]      DWORD                     Flags,
            PVOID                     Reserved
);

Paramètres

[in] DeviceInfoSet

Handle du jeu d’informations sur l’appareil qui contient l’interface de l’appareil à définir comme valeur par défaut pour une classe d’interface d’appareil.

[in, out] DeviceInterfaceData

Pointeur vers une structure de SP_DEVICE_INTERFACE_DATA qui spécifie l’interface de l’appareil dans DeviceInfoSet.

[in] Flags

Non utilisé, doit être égal à zéro.

Reserved

Réservé pour une utilisation future, doit avoir la valeur NULL.

Valeur retournée

La fonction retourne TRUE si elle réussit. Sinon, il retourne FALSE et l’erreur journalisée peut être récupérée avec un appel à GetLastError.

Remarques

Un appelant doit disposer de privilèges d’administrateur pour définir l’interface par défaut pour une classe d’interface d’appareil. Toutefois, si l’interface par défaut demandée est identique à l’interface par défaut actuellement définie, la fonction retourne TRUE , que l’appelant dispose ou non de privilèges d’administrateur.

Si la fonction définit correctement l’interface d’appareil spécifiée comme valeur par défaut pour la classe d’appareil, elle met à jour le membre Flags de la structure SP_DEVICE_INTERFACE_DATA fournie.

Appelez SetupDiGetClassDevs pour obtenir un handle DevInfoSet pour un jeu d’informations sur l’appareil qui contient l’interface de l’appareil à définir comme valeur par défaut pour une classe d’interface d’appareil. Pour obtenir le pointeur DeviceInterfaceData vers l’élément d’interface de l’appareil, appelez SetupDiEnumDeviceInterfaces pour énumérer les interfaces dans le jeu d’informations de l’appareil. Pour récupérer des informations sur une interface énumérée, appelez SetupDiGetDeviceInterfaceDetail.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows XP et les versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	setupapi.h (inclure Setupapi.h)
Bibliothèque	Setupapi.lib
DLL	Setupapi.dll

Voir aussi

SetupDiEnumDeviceInterfaces

SetupDiGetClassDevs

SetupDiGetDeviceInterfaceDetail