Freigeben über


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.

Screenshot eines Dialogfelds

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)

Siehe auch

DIF_SELECTDEVICE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller-

SetupDiSelectDevice