структура SP_SELECTDEVICE_PARAMS_A (setupapi.h)
Структура SP_SELECTDEVICE_PARAMS соответствует запросу на установку DIF_SELECTDEVICE.
Синтаксис
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;
Члены
ClassInstallHeader
Заголовок запроса установки, содержащий размер заголовка и код DIF для запроса. См. SP_CLASSINSTALL_HEADER.
Title[MAX_TITLE_LEN]
Буфер, содержащий заголовок окна, предоставленного установщиком, для окон выбора драйверов. Windows использует это название для заголовка окна для диалоговых окон "Выбор устройства".
Instructions[MAX_INSTRUCTION_LEN]
Буфер, содержащий инструкции по выбору устройства, предоставленные установщиком.
ListLabel[MAX_LABEL_LEN]
Буфер, содержащий метку, предоставляемую установщиком, для списка драйверов, из которых пользователь может выбрать.
SubTitle[MAX_SUBTITLE_LEN]
Буфер, содержащий предоставленный установщиком подзаголовок, используемый в мастерах выбора устройств. Эта строка не используется в диалоговых окнах выбора.
Reserved[2]
Скрытный. Только для внутреннего использования.
Замечания
Если установщик задает поля в этой структуре для использования во время выбора драйвера, установщик также должен задать флаг DI_USECI_SELECTSTRINGS в SP_DEVINSTALL_PARAMS.
На следующем снимке экрана показан пример диалогового окна выбора устройства и определяет строки, которые может предоставить установщик.
Заметка
Заголовок setupapi.h определяет SP_SELECTDEVICE_PARAMS как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| заголовка | setupapi.h (include Setupapi.h) |