структура SP_PROPCHANGE_PARAMS (setupapi.h)

  • Статья

Структура SP_PROPCHANGE_PARAMS соответствует запросу на установку DIF_PROPERTYCHANGE .

Синтаксис

typedef struct _SP_PROPCHANGE_PARAMS {
  SP_CLASSINSTALL_HEADER ClassInstallHeader;
  DWORD                  StateChange;
  DWORD                  Scope;
  DWORD                  HwProfile;
} SP_PROPCHANGE_PARAMS, *PSP_PROPCHANGE_PARAMS;

Члены

ClassInstallHeader

Заголовок запроса на установку, содержащий размер заголовка и код DIF для запроса. См . SP_CLASSINSTALL_HEADER.

StateChange

Действие изменения состояния. Может иметь одно из следующих значений:

DICS_ENABLE

Устройство включено.

Для этого изменения состояния Windows включает устройство, если указан флаг DICS_FLAG_GLOBAL .

Если указан флаг DICS_FLAG_CONFIGSPECIFIC и указан текущий профиль оборудования, Windows включает устройство. Если указан DICS_FLAG_CONFIGSPECIFIC , а не текущий профиль оборудования, Windows устанавливает некоторые флаги в реестре и не изменяет состояние устройства. Windows изменит состояние устройства, когда указанный профиль станет текущим.

DICS_DISABLE

Устройство отключено.

Для этого изменения состояния Windows отключает устройство, если указан флаг DICS_FLAG_GLOBAL .

Если указан флаг DICS_FLAG_CONFIGSPECIFIC и указан текущий профиль оборудования, Windows отключает устройство. Если указан DICS_FLAG_CONFIGSPECIFIC , а не текущий профиль оборудования, Windows устанавливает некоторые флаги в реестре и не изменяет состояние устройства.

DICS_PROPCHANGE

Свойства устройства изменились.

При этом изменении состояния Windows игнорирует сведения о области , если это допустимое значение, и останавливает и перезапускает устройство.

DICS_START

Устройство запускается (если запрос на текущий активный профиль оборудования).

DICS_START должно быть DICS_FLAG_CONFIGSPECIFIC. Это изменение невозможно выполнить глобально.

Windows запускает устройство только в том случае, если указан текущий профиль оборудования. В противном случае Windows устанавливает флаг реестра и не изменяет состояние устройства.

DICS_STOP

Устройство останавливается. Стек драйверов будет выгружен, а для устройства будет установлен флаг CSCONFIGFLAG_DO_NOT_START.

DICS_STOP должно быть DICS_FLAG_CONFIGSPECIFIC. Это изменение невозможно выполнить глобально.

Windows останавливает устройство, только если указан текущий профиль оборудования. В противном случае Windows устанавливает флаг реестра и не изменяет состояние устройства.

Компоненты не должны указывать DICS_STOP или DICS_START. Вместо этого они должны использовать DICS_PROPCHANGE для остановки и перезапуска устройства, чтобы изменения в конфигурации устройства вступили в силу.

Scope

Флаги, указывающие область изменения свойства устройства. Может применяться один из перечисленных ниже типов.

DICS_FLAG_GLOBAL

Внесите изменения во все профили оборудования.

DICS_FLAG_CONFIGSPECIFIC

Внесите изменения только в указанный профиль.

Следующий флаг устарел:

DICS_FLAG_CONFIGGENERAL

HwProfile

Предоставляет идентификатор профиля оборудования для изменений, относящихся к конкретному профилю. Ноль указывает текущий профиль оборудования.

Требования

Требование Значение
Заголовок setupapi.h (включая Setupapi.h)

См. также раздел

DIF_PROPERTYCHANGE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiChangeState