SetupDiSelectDevice-Funktion (setupapi.h)

Die SetupDiSelectDevice-Funktion ist der Standardhandler für die DIF_SELECTDEVICE-Anforderung .

Syntax

WINSETUPAPI BOOL SetupDiSelectDevice(
  [in]      HDEVINFO         DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA DeviceInfoData
);

Parameter

[in] DeviceInfoSet

Ein Handle für einen Geräteinformationssatz , der ein Geräteinformationselement enthält, das das Gerät darstellt, für das ein Treiber ausgewählt werden soll.

[in, out] DeviceInfoData

Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur , die das Geräteinformationselement angibt. Dieser Parameter ist optional und kann NULL sein. Wenn dieser Parameter angegeben ist, wählt SetupDiSelectDevice den Treiber für das angegebene Gerät aus und legt DeviceInfoData fest.ClassGuid für die GUID der Gerätesetupklasse für den ausgewählten Treiber. Wenn dieser Parameter NULL ist, legt SetupDiSelectDevice den ausgewählten Treiber in der globalen Klassentreiberliste für DeviceInfoSet fest.

Rückgabewert

Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann durch einen Aufruf von GetLastError abgerufen werden.

Hinweise

SetupDiSelectDevice verarbeitet die Benutzeroberfläche, über die der Benutzer einen Treiber für das angegebene Gerät oder eine Geräteinformation auswählen kann, wenn kein Gerät angegeben wird. Durch Festlegen des Felds Flags der SP_DEVINSTALL_PARAMS-Struktur für das Gerät oder durch Festlegen der Geräteinformationen, wenn ein Gerät nicht angegeben wird, kann der Aufrufer eine spezielle Behandlung der Benutzeroberfläche angeben, z. B. damit Benutzer einen Treiber aus einem OEM-Installationsdatenträger auswählen können.

Hinweis Nur ein Klasseninstallationsprogramm sollte SetupDiSelectDevice aufrufen und nur in situationen, in denen das Klasseninstallationsprogramm Treiberauswahlvorgänge ausführen muss, nachdem SetupDiSelectDevice den Standardtreiberauswahlvorgang abgeschlossen hat. In solchen Situationen muss das Klasseninstallationsprogramm SetupDiSelectDevice direkt aufrufen, wenn das Installationsprogramm eine DIF_SELECTDEVICE-Anforderung verarbeitet. Weitere Informationen zum Aufrufen des Standardhandlers finden Sie unter Aufrufen von DIF-Standardcodehandlern.

 

SetupDiSelectDevice wurde in erster Linie entwickelt, um vor der Installation des Geräts einen Treiber für ein Gerät auf einem lokalen Computer auszuwählen. Obwohl SetupDiSelectDevice nicht fehlschlägt, wenn der Geräteinformationssatz für einen Remotecomputer gilt, ist das Ergebnis nur eingeschränkt nutzbar, da der Geräteinformationssatz anschließend nicht mit DIF_Xxx-Installationsanforderungen oder SetupDi Xxx-Funktionen verwendet werden kann, die keine Vorgänge auf einem Remotecomputer unterstützen. Insbesondere kann der Geräteinformationssatz nicht als Eingabe mit einer DIF_INSTALLDEVICE Installationsanforderung verwendet werden, um ein Gerät auf einem Remotecomputer zu installieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform	Desktop
Kopfzeile	setupapi.h (schließen Sie Setupapi.h ein)
Bibliothek	Setupapi.lib
DLL	Setupapi.dll

Weitere Informationen

SP_DEVINSTALL_PARAMS

SetupDiCallClassInstaller