Функция SetupDiSelectOEMDrv (setupapi.h)
Функция SetupDiSelectOEMDrv выбирает драйвер для набора сведений об устройстве или определенный элемент сведений об устройстве, использующий путь OEM, предоставленный пользователем.
Синтаксис
WINSETUPAPI BOOL SetupDiSelectOEMDrv(
[in, optional] HWND hwndParent,
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVINFO_DATA DeviceInfoData
);
Параметры
[in, optional] hwndParent
Дескриптор окна, который будет родительским для всех диалогов, созданных во время обработки этой функции. Этот параметр можно использовать для переопределения поля hwndParent в блоке параметров установки указанного набора сведений об устройстве или элемента.
[in] DeviceInfoSet
Дескриптор набора сведений об устройстве , для которого нужно выбрать драйвер.
[in, out] DeviceInfoData
Указатель на структуру SP_DEVINFO_DATA , указывающую элемент сведений об устройстве в DeviceInfoSet. Этот параметр является необязательным и может иметь значение NULL. Если этот параметр указан, SetupDiSelectOEMDrv связывает выбранный драйвер с указанным устройством. Если этот параметр имеет значение NULL, SetupDiSelectOEMDrv связывает выбранный драйвер со списком драйверов глобального класса для DeviceInfoSet.
Возвращаемое значение
Функция возвращает значение TRUE в случае успешного выполнения. В противном случае возвращается значение FALSE , а зарегистрированная ошибка может быть получена вызовом Метода GetLastError.
Комментарии
SetupDiSelectOEMDrv в первую очередь предназначен для выбора драйвера OEM для устройства на локальном компьютере перед установкой устройства на этом компьютере. Хотя setupDiSelectOEMDrv не завершится сбоем, если набор сведений об устройстве предназначен для удаленного компьютера, это приведет к ограниченному использованию, так как набор сведений об устройстве впоследствии не может использоваться с запросами на установку DIF_Xxx илифункциями SetupDiXxx , которые не поддерживают операции на удаленном компьютере. В частности, набор сведений об устройстве нельзя использовать в качестве входных данных с запросом на установку DIF_INSTALLDEVICE для установки устройства на удаленном компьютере.
SetupDiSelectOEMDrv запрашивает у пользователя путь oem, а затем вызывает установщик класса, чтобы выбрать драйвер из пути oem.
Требования
| Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | setupapi.h (включая Setupapi.h) |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |