SP_DETECTDEVICE_PARAMS structure (setupapi.h)

Une structure SP_DETECTDEVICE_PARAMS correspond à une demande d’installation DIF_DETECT.

Syntaxe

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

Membres

ClassInstallHeader

En-tête de demande d’installation qui contient la taille de l’en-tête et le code DIF pour la demande. Voir SP_CLASSINSTALL_HEADER.

DetectProgressNotify

Routine de rappel qui affiche une barre de progression pour l’opération de détection d’appareil. La routine de rappel est fournie par le composant d’installation de l’appareil qui envoie la demande DIF_DETECT . Le rappel a le prototype suivant :

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

ProgressNotifyParam est un « handle » opaque qui identifie l’opération de détection. Cette valeur est fournie par le composant d’installation de l’appareil qui a envoyé la demande DIF_DETECT.

DetectComplete est une valeur comprise entre 0 et 100 qui indique le pourcentage d’achèvement. Le programme d’installation de classe incrémente cette valeur à différentes étapes de ses activités de détection, pour informer l’utilisateur de sa progression.

ProgressNotifyParam

« handle » progressNotifyParam opaque que le programme d’installation de classe passe à la routine de rappel de progression.

Configuration requise

Voir aussi

DIF_DETECT

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller