SP_SELECTDEVICE_PARAMS_A struttura (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;

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 la finestra di dialogo Seleziona dispositivo.

Instructions[MAX_INSTRUCTION_LEN]

Buffer che contiene istruzioni select-device fornite dal programma di installazione.

ListLabel[MAX_LABEL_LEN]

Buffer contenente un'etichetta fornita dal programma di installazione per l'elenco di driver da cui è possibile selezionare l'utente.

SubTitle[MAX_SUBTITLE_LEN]

Buffer contenente un sottotitolo fornito dal programma di installazione usato nelle procedure guidate select-device. Questa stringa non viene usata nelle finestre di dialogo selezionate.

Reserved[2]

Riservato. Solo per uso interno.

Commenti

Se un programma di installazione imposta i campi in questa struttura da usare durante la selezione del driver, il programma di installazione deve anche impostare il flag di DI_USECI_SELECTSTRINGS nell'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 di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

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

Vedi anche

DIF_SELECTDEVICE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiSelectDevice