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
DeviceInfoSet에서 디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 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 |