estrutura SP_SELECTDEVICE_PARAMS_A (setupapi.h)
Uma estrutura de SP_SELECTDEVICE_PARAMS corresponde a uma solicitação de instalação DIF_SELECTDEVICE.
Sintaxe
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;
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 selecionadas.
Reserved[2]
Reservado. Somente para uso interno.
Observações
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.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
Requisito | Valor |
---|---|
cabeçalho | setupapi.h (inclua Setupapi.h) |