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;

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.

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.

schermata 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 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)

Vedere anche

DIF_SELECTDEVICE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiSelectDevice