SP_DETECTDEVICE_PARAMS structure (setupapi.h)

An SP_DETECTDEVICE_PARAMS structure corresponds to a DIF_DETECT installation request.

Syntax

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

Members

ClassInstallHeader

An install request header that contains the size of the header and the DIF code for the request. See SP_CLASSINSTALL_HEADER.

DetectProgressNotify

A callback routine that displays a progress bar for the device detection operation. The callback routine is supplied by the device installation component that sends the DIF_DETECT request. The callback has the following prototype:

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

ProgressNotifyParam is an opaque "handle" that identifies the detection operation. This value is supplied by the device installation component that sent the DIF_DETECT request.

DetectComplete is a value between 0 and 100 that indicates the percent completion. The class installer increments this value at various stages of its detection activities, to notify the user of its progress.

ProgressNotifyParam

The opaque ProgressNotifyParam "handle" that the class installer passes to the progress callback routine.

Requirements

Requirement	Value
Header	setupapi.h (include Setupapi.h)

See also

DIF_DETECT

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller