struttura SP_SELECTDEVICE_PARAMS_A (setupapi.h)
Una struttura SP_SELECTDEVICE_PARAMS corrisponde a una richiesta di installazione DIF_SELECTDEVICE.
Sintassi
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;
Membri
ClassInstallHeader
Intestazione della richiesta di installazione che contiene le dimensioni dell'intestazione e il codice DIF per la richiesta. Vedere SP_CLASSINSTALL_HEADER.
Title[MAX_TITLE_LEN]
Buffer che contiene un titolo della finestra fornito dal programma di installazione per le finestre di selezione driver. Windows usa questo titolo per il titolo della finestra per le finestre di dialogo Seleziona dispositivo.
Instructions[MAX_INSTRUCTION_LEN]
Buffer che contiene istruzioni select-device fornite dal programma di installazione.
ListLabel[MAX_LABEL_LEN]
Buffer che contiene un'etichetta fornita dal programma di installazione per l'elenco dei driver da cui l'utente può selezionare.
SubTitle[MAX_SUBTITLE_LEN]
Buffer che contiene un sottotitolo fornito dal programma di installazione usato nelle procedure guidate select-device. Questa stringa non viene usata nelle finestre di dialogo di selezione.
Reserved[2]
Riservato. Solo per uso interno.
Osservazioni
Se un programma di installazione imposta campi in questa struttura da utilizzare durante la selezione del driver, il programma di installazione deve anche impostare il flag DI_USECI_SELECTSTRINGS nel SP_DEVINSTALL_PARAMS.
La schermata seguente mostra una finestra di dialogo Seleziona dispositivo di esempio e identifica le stringhe che un programma di installazione può fornire.
Nota
L'intestazione setupapi.h definisce SP_SELECTDEVICE_PARAMS come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione |
setupapi.h (include Setupapi.h) |