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 |