SP_DETECTDEVICE_PARAMS-Struktur (setupapi.h)

Eine SP_DETECTDEVICE_PARAMS-Struktur entspricht einer DIF_DETECT Installationsanforderung.

Syntax

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

Member

ClassInstallHeader

Ein Installationsanforderungsheader, der die Größe des Headers und den DIF-Code für die Anforderung enthält. Siehe SP_CLASSINSTALL_HEADER.

DetectProgressNotify

Eine Rückrufroutine, die eine Statusanzeige für den Geräteerkennungsvorgang anzeigt. Die Rückrufroutine wird von der Geräteinstallationskomponente bereitgestellt, die die DIF_DETECT-Anforderung sendet. Der Rückruf verfügt über den folgenden Prototyp:

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

ProgressNotifyParam ist ein undurchsichtiges "Handle", das den Erkennungsvorgang identifiziert. Dieser Wert wird von der Geräteinstallationskomponente bereitgestellt, die die DIF_DETECT-Anforderung gesendet hat.

DetectComplete ist ein Wert zwischen 0 und 100, der die prozentuale Vervollständigung angibt. Das Klasseninstallationsprogramm erhöht diesen Wert in verschiedenen Phasen seiner Erkennungsaktivitäten, um den Benutzer über den Fortschritt zu informieren.

ProgressNotifyParam

Das undurchsichtige ProgressNotifyParam -"Handle", das das Klasseninstallationsprogramm an die Statusrückrufroutine übergibt.

Anforderungen

Weitere Informationen

DIF_DETECT

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller