структура 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)

См. также

DIF_SELECTDEVICE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiSelectDevice