Condividi tramite


struttura SP_SELECTDEVICE_PARAMS_W (setupapi.h)

Una struttura SP_SELECTDEVICE_PARAMS corrisponde a una richiesta di installazione DIF_SELECTDEVICE .

Sintassi

typedef struct _SP_SELECTDEVICE_PARAMS_W {
  SP_CLASSINSTALL_HEADER ClassInstallHeader;
  WCHAR                  Title[MAX_TITLE_LEN];
  WCHAR                  Instructions[MAX_INSTRUCTION_LEN];
  WCHAR                  ListLabel[MAX_LABEL_LEN];
  WCHAR                  SubTitle[MAX_SUBTITLE_LEN];
} SP_SELECTDEVICE_PARAMS_W, *PSP_SELECTDEVICE_PARAMS_W;

Members

ClassInstallHeader

Intestazione della richiesta di installazione contenente le dimensioni dell'intestazione e il codice DIF per la richiesta. Vedere SP_CLASSINSTALL_HEADER.

Title[MAX_TITLE_LEN]

Buffer contenente 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 contenente le istruzioni del programma di installazione 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.

Commenti

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.

Screenshot di una finestra di dialogo Seleziona driver di dispositivo

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Intestazione setupapi.h (include Setupapi.h)

Vedi anche

DIF_SELECTDEVICE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiSelectDevice