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;
Angehörige
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 Auswahlgeräteanweisungen 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 Auswahlgeräte-Assistenten verwendet wird. Diese Zeichenfolge wird in ausgewählten Dialogfeldern nicht verwendet.
Reserved[2]
Reserviert. Nur für die interne Verwendung.
Bemerkungen
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.
Anmerkung
Der header setupapi.h 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 Code, der nicht codierungsneutral ist, 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 (include Setupapi.h) |