structure SP_SELECTDEVICE_PARAMS_A (setupapi.h)
Une structure SP_SELECTDEVICE_PARAMS correspond à une demande d’installation DIF_SELECTDEVICE.
Syntaxe
typedef struct _SP_SELECTDEVICE_PARAMS_A {
SP_CLASSINSTALL_HEADER ClassInstallHeader;
CHAR Title[MAX_TITLE_LEN];
CHAR Instructions[MAX_INSTRUCTION_LEN];
CHAR ListLabel[MAX_LABEL_LEN];
CHAR SubTitle[MAX_SUBTITLE_LEN];
BYTE Reserved[2];
} SP_SELECTDEVICE_PARAMS_A, *PSP_SELECTDEVICE_PARAMS_A;
Membres
ClassInstallHeader
En-tête de demande d’installation qui contient la taille d’en-tête et le code DIF de la requête. Voir SP_CLASSINSTALL_HEADER.
Title[MAX_TITLE_LEN]
Mémoire tampon qui contient un titre de fenêtre fourni par le programme d’installation pour les fenêtres de sélection de pilotes. Windows utilise ce titre pour le titre de la fenêtre pour les boîtes de dialogue Sélectionner un appareil.
Instructions[MAX_INSTRUCTION_LEN]
Mémoire tampon qui contient des instructions select-device fournies par le programme d’installation.
ListLabel[MAX_LABEL_LEN]
Mémoire tampon qui contient une étiquette fournie par le programme d’installation pour la liste des pilotes à partir desquels l’utilisateur peut sélectionner.
SubTitle[MAX_SUBTITLE_LEN]
Mémoire tampon qui contient un sous-titre fourni par le programme d’installation utilisé dans les Assistants select-device. Cette chaîne n’est pas utilisée dans les dialogues de sélection.
Reserved[2]
Réservé. Pour une utilisation interne uniquement.
Remarques
Si un programme d’installation définit les champs de cette structure à utiliser lors de la sélection du pilote, le programme d’installation doit également définir l’indicateur DI_USECI_SELECTSTRINGS dans le SP_DEVINSTALL_PARAMS.
La capture d’écran suivante montre un exemple de boîte de dialogue Sélectionner un appareil et identifie les chaînes qu’un programme d’installation peut fournir.
Note
L’en-tête setupapi.h définit SP_SELECTDEVICE_PARAMS en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | setupapi.h (include Setupapi.h) |