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)

Weitere Informationen

DIF_SELECTDEVICE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiSelectDevice