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
| Anforderung | Wert |
|---|---|
| Header | setupapi.h (einschließlich Setupapi.h) |