struttura SP_DETECTDEVICE_PARAMS (setupapi.h)

Articolo
03/05/2024

Una struttura SP_DETECTDEVICE_PARAMS corrisponde a una richiesta di installazione DIF_DETECT.

Sintassi

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

Members

ClassInstallHeader

Intestazione della richiesta di installazione contenente le dimensioni dell'intestazione e il codice DIF per la richiesta. Vedere SP_CLASSINSTALL_HEADER.

DetectProgressNotify

Routine di callback che visualizza un indicatore di stato per l'operazione di rilevamento del dispositivo. La routine di callback viene fornita dal componente di installazione del dispositivo che invia la richiesta di DIF_DETECT . Il callback ha il prototipo seguente:

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

ProgressNotifyParam è un "handle" opaco che identifica l'operazione di rilevamento. Questo valore viene fornito dal componente di installazione del dispositivo che ha inviato la richiesta di DIF_DETECT.

DetectComplete è un valore compreso tra 0 e 100 che indica il completamento della percentuale. Il programma di installazione classi incrementa questo valore in varie fasi delle attività di rilevamento per notificare all'utente lo stato di avanzamento.

ProgressNotifyParam

Oggetto ProgressNotifyParam opaco "handle" che il programma di installazione della classe passa alla routine di callback di stato.