SP_SELECTDEVICE_PARAMS_W Struktur (setupapi.h)

Eine SP_SELECTDEVICE_PARAMS-Struktur entspricht einer DIF_SELECTDEVICE Installationsanforderung.

Syntax

typedef struct _SP_SELECTDEVICE_PARAMS_W {
  SP_CLASSINSTALL_HEADER ClassInstallHeader;
  WCHAR                  Title[MAX_TITLE_LEN];
  WCHAR                  Instructions[MAX_INSTRUCTION_LEN];
  WCHAR                  ListLabel[MAX_LABEL_LEN];
  WCHAR                  SubTitle[MAX_SUBTITLE_LEN];
} SP_SELECTDEVICE_PARAMS_W, *PSP_SELECTDEVICE_PARAMS_W;

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.

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