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 |