SP_SELECTDEVICE_PARAMS_A-Struktur (setupapi.h)
Eine SP_SELECTDEVICE_PARAMS-Struktur entspricht einer DIF_SELECTDEVICE Installationsanforderung.
Syntax
typedef struct _SP_SELECTDEVICE_PARAMS_A {
SP_CLASSINSTALL_HEADER ClassInstallHeader;
CHAR Title[MAX_TITLE_LEN];
CHAR Instructions[MAX_INSTRUCTION_LEN];
CHAR ListLabel[MAX_LABEL_LEN];
CHAR SubTitle[MAX_SUBTITLE_LEN];
BYTE Reserved[2];
} SP_SELECTDEVICE_PARAMS_A, *PSP_SELECTDEVICE_PARAMS_A;
Member
ClassInstallHeader
Ein Installationsanforderungsheader, der die Headergröße und den DIF-Code für die Anforderung enthält. Siehe SP_CLASSINSTALL_HEADER.
Title[MAX_TITLE_LEN]
Puffer, der einen vom Installationsprogramm bereitgestellten Fenstertitel für Treiberauswahlfenster enthält. Windows verwendet diesen Titel für den Fenstertitel für die Dialogfelder Gerät auswählen.
Instructions[MAX_INSTRUCTION_LEN]
Puffer, der eine vom Installationsprogramm bereitgestellte Geräteauswahlanleitung enthält.
ListLabel[MAX_LABEL_LEN]
Puffer, der eine vom Installationsprogramm bereitgestellte Bezeichnung für die Liste der Treiber enthält, aus denen der Benutzer auswählen kann.
SubTitle[MAX_SUBTITLE_LEN]
Puffer, der einen vom Installationsprogramm bereitgestellten Untertitel enthält, der in Assistenten für ausgewählte Geräte verwendet wird. Diese Zeichenfolge wird in Auswahldialogfeldern nicht verwendet.
Reserved[2]
Reserviert. Nur zur internen Verwendung.
Hinweise
Wenn ein Installationsprogramm Felder in dieser Struktur festlegt, die während der Treiberauswahl verwendet werden sollen, muss das Installationsprogramm auch das DI_USECI_SELECTSTRINGS-Flag im SP_DEVINSTALL_PARAMS festlegen.
Der folgende Screenshot zeigt ein Beispieldialogfeld Gerät auswählen und identifiziert die Zeichenfolgen, die ein Installationsprogramm bereitstellen kann.
Hinweis
Der setupapi.h-Header definiert SP_SELECTDEVICE_PARAMS als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | setupapi.h (einschließlich Setupapi.h) |