estructura SP_DETECTDEVICE_PARAMS (setupapi.h)

Artículo
03/13/2024

Una estructura de SP_DETECTDEVICE_PARAMS corresponde a una solicitud de instalación de DIF_DETECT.

Sintaxis

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

Miembros

ClassInstallHeader

Encabezado de solicitud de instalación que contiene el tamaño del encabezado y el código DIF de la solicitud. Consulte SP_CLASSINSTALL_HEADER.

DetectProgressNotify

Rutina de devolución de llamada que muestra una barra de progreso para la operación de detección de dispositivos. El componente de instalación del dispositivo proporciona la rutina de devolución de llamada que envía la solicitud de DIF_DETECT . La devolución de llamada tiene el prototipo siguiente:

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

ProgressNotifyParam es un "identificador" opaco que identifica la operación de detección. Este valor lo proporciona el componente de instalación del dispositivo que envió la solicitud de DIF_DETECT.

DetectComplete es un valor entre 0 y 100 que indica el porcentaje de finalización. El instalador de clase incrementa este valor en varias fases de sus actividades de detección para notificar al usuario su progreso.

ProgressNotifyParam

El "identificador" progressNotifyParam opaco que el instalador de clase pasa a la rutina de devolución de llamada de progreso.