estrutura SP_SELECTDEVICE_PARAMS_W (setupapi.h)

Uma estrutura SP_SELECTDEVICE_PARAMS corresponde a uma solicitação de instalação DIF_SELECTDEVICE .

Sintaxe

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;

Membros

ClassInstallHeader

Um cabeçalho de solicitação de instalação que contém o tamanho do cabeçalho e o código DIF da solicitação. Consulte SP_CLASSINSTALL_HEADER.

Title[MAX_TITLE_LEN]

Buffer que contém um título de janela fornecido pelo instalador para janelas de seleção de driver. O Windows usa esse título para o título da janela para as caixas de diálogo Selecionar Dispositivo.

Instructions[MAX_INSTRUCTION_LEN]

Buffer que contém instruções de select-device fornecidas pelo instalador.

ListLabel[MAX_LABEL_LEN]

Buffer que contém um rótulo fornecido pelo instalador para a lista de drivers dos quais o usuário pode selecionar.

SubTitle[MAX_SUBTITLE_LEN]

Buffer que contém um subtítulo fornecido pelo instalador usado em assistentes select-device. Essa cadeia de caracteres não é usada em caixas de diálogo de seleção.

Comentários

Se um instalador definir campos nessa estrutura a serem usados durante a seleção do driver, o instalador também deverá definir o sinalizador DI_USECI_SELECTSTRINGS no SP_DEVINSTALL_PARAMS.

A captura de tela a seguir mostra uma caixa de diálogo Selecionar Dispositivo de exemplo e identifica as cadeias de caracteres que um instalador pode fornecer.

Observação

O cabeçalho setupapi.h define SP_SELECTDEVICE_PARAMS como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cabeçalho	setupapi.h (inclua Setupapi.h)

Confira também

DIF_SELECTDEVICE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiSelectDevice