SetupDiSelectOEMDrv-Funktion (setupapi.h)

Die SetupDiSelectOEMDrv-Funktion wählt einen Treiber für einen Geräteinformationssatz oder ein bestimmtes Geräteinformationselement aus, das einen vom Benutzer bereitgestellten OEM-Pfad verwendet.

Syntax

WINSETUPAPI BOOL SetupDiSelectOEMDrv(
  [in, optional] HWND             hwndParent,
  [in]           HDEVINFO         DeviceInfoSet,
  [in, out]      PSP_DEVINFO_DATA DeviceInfoData
);

Parameter

[in, optional] hwndParent

Ein Fensterhandle, das das übergeordnete Element aller Dialoge ist, die während der Verarbeitung dieser Funktion erstellt wurden. Dieser Parameter kann verwendet werden, um das Feld hwndParent im Installationsparameterblock des angegebenen Geräteinformationssatzes oder -elements außer Kraft zu setzen.

[in] DeviceInfoSet

Ein Handle für den Geräteinformationssatz , für den ein Treiber ausgewählt werden soll.

[in, out] DeviceInfoData

Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur , die ein Geräteinformationselement in DeviceInfoSet angibt. Dieser Parameter ist optional und kann NULL sein. Wenn dieser Parameter angegeben ist, ordnet SetupDiSelectOEMDrv den ausgewählten Treiber dem angegebenen Gerät zu. Wenn dieser Parameter NULL ist, ordnet SetupDiSelectOEMDrv den ausgewählten Treiber der globalen Klassentreiberliste für DeviceInfoSet zu.

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

SetupDiSelectOEMDrv wurde in erster Linie entwickelt, um einen OEM-Treiber für ein Gerät auf einem lokalen Computer auszuwählen, bevor das Gerät auf diesem Computer installiert wird. Obwohl SetupDiSelectOEMDrv nicht fehlschlägt, wenn der Geräteinformationssatz für einen Remotecomputer bestimmt ist, 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.

SetupDiSelectOEMDrv fordert den Benutzer zur Eingabe des OEM-Pfads auf und ruft dann das Klasseninstallationsprogramm auf, um einen Treiber aus dem OEM-Pfad auszuwählen.

Anforderungen

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

SetupDiAskForOEMDisk