SP_DETECTDEVICE_PARAMS structure (setupapi.h)
An SP_DETECTDEVICE_PARAMS structure corresponds to a DIF_DETECT installation request.
typedef struct _SP_DETECTDEVICE_PARAMS {
SP_CLASSINSTALL_HEADER ClassInstallHeader;
PDETECT_PROGRESS_NOTIFY DetectProgressNotify;
PVOID ProgressNotifyParam;
} SP_DETECTDEVICE_PARAMS, *PSP_DETECTDEVICE_PARAMS;
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.
Requirement | Value |
---|---|
Header | setupapi.h (include Setupapi.h) |