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

Статья
03/01/2024

Структура SP_DETECTDEVICE_PARAMS соответствует запросу на установку DIF_DETECT.

Синтаксис

typedef struct _SP_DETECTDEVICE_PARAMS {
  SP_CLASSINSTALL_HEADER  ClassInstallHeader;
  PDETECT_PROGRESS_NOTIFY DetectProgressNotify;
  PVOID                   ProgressNotifyParam;
} SP_DETECTDEVICE_PARAMS, *PSP_DETECTDEVICE_PARAMS;

Члены

ClassInstallHeader

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

DetectProgressNotify

Подпрограмма обратного вызова, отображающая индикатор выполнения операции обнаружения устройства. Подпрограмма обратного вызова предоставляется компонентом установки устройства , который отправляет запрос DIF_DETECT . Обратный вызов имеет следующий прототип:

typedef BOOL (CALLBACK* PDETECT_PROGRESS_NOTIFY)(
    IN PVOID ProgressNotifyParam,
    IN DWORD DetectComplete
    );

ProgressNotifyParam — это непрозрачный дескриптор, который определяет операцию обнаружения. Это значение предоставляется компонентом установки устройства , отправив DIF_DETECT запрос.

DetectComplete — это значение от 0 до 100, указывающее процент завершения. Установщик класса увеличивает это значение на различных этапах своих действий обнаружения, чтобы уведомить пользователя о ходе выполнения.

ProgressNotifyParam

Непрозрачный дескриптор ProgressNotifyParam , который установщик класса передает в подпрограмму обратного вызова хода выполнения.