DIF_NEWDEVICEWIZARD_SELECT

아티클
06/15/2023

DIF_NEWDEVICEWIZARD_SELECT 요청을 사용하면 설치 관리자가 표준 select-driver 페이지를 대체하는 사용자 지정 마법사 페이지를 제공할 수 있습니다. 이 요청은 PnP가 아닌 디바이스를 수동으로 설치하는 동안에만 사용됩니다.

보낸 경우

Windows가 "디바이스 드라이버 선택" 페이지를 표시하기 직전에

처리할 사람

클래스 공동 설치 관리자	처리 가능
디바이스 공동 설치 관리자	처리하지 않음
클래스 설치 관리자	처리 가능

설치 관리자 입력

DeviceInfoSet
디바이스가 포함된 디바이스 정보 집합 에 핸들을 제공합니다.

DeviceInfoData
디바이스 정보 집합에서 디바이스를 식별하는 SP_DEVINFO_DATA 구조체에 대한 포인터를 제공합니다.

디바이스 설치 매개 변수
DeviceInfoData와 연결된 디바이스 설치 매개 변수(SP_DEVINSTALL_PARAMS)가 있습니다.

클래스 설치 매개 변수
SP_NEWDEVICEWIZARD_DATA 구조체는 DeviceInfoData와 연결됩니다.

설치 관리자 출력

디바이스 설치 매개 변수
설치 관리자는 디바이스 설치 매개 변수의 플래그를 수정할 수 있습니다. Windows는 이 DIF 요청이 완료될 때 플래그를 검사 않습니다. 그러나 설치 프로세스의 뒷부분에서 확인합니다.

클래스 설치 매개 변수
설치 관리자는 사용자 지정 페이지를 제공하기 위해 SP_NEWDEVICEWIZARD_DATA 수정할 수 있습니다.

설치 관리자 반환 값

공동 설치 관리자가 이 DIF 요청을 처리하지 않으면 전처리 패스에서 NO_ERROR 반환합니다. 공동 설치 관리자가 이 요청을 처리하는 경우 NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED 또는 Win32 오류 코드를 반환할 수 있습니다.

클래스 설치 관리자가 페이지를 성공적으로 제공하면 NO_ERROR 반환합니다. 그렇지 않으면 클래스 설치 관리자가 ERROR_DI_DO_DEFAULT 또는 Win32 오류 코드를 반환합니다.

기본 DIF 코드 처리기

없음

설치 관리자 작업

설치 관리자가 이 DIF 요청에 응답하여 표준 선택 드라이버 마법사 페이지를 완전히 바꿉니다. 대신 설치 관리자가 표준 페이지를 수정하거나 선택할 드라이버 목록을 수정해야 하는 경우 설치 관리자는 DIF_SELECTDEVICE 요청에 대한 응답으로 이 작업을 수행해야 합니다.

공동 설치 관리자는 사후 처리 패스에 사용자 지정 페이지를 추가하고 클래스 설치 관리자가 사용자 지정 페이지를 추가하지 않은 경우에만 추가해야 합니다. 클래스 설치 관리자가 페이지를 추가한 경우 공동 설치 관리자는 추가하지 않아야 합니다. 그렇지 않으면 사용자에게 드라이버를 두 번 선택하라는 메시지가 표시될 수 있습니다.

설치 관리자가 사용자 지정 선택 페이지를 제공하는 경우 설치 관리자는 선택한 드라이버를 설정해야 합니다. 마법사 페이지를 지원하는 설치 관리자 코드에서 사용자가 다음을 클릭한 후 설치 관리자는 SetupDiSetSelectedDriver를 호출해야 합니다.

설치 관리자는 사용자 지정 마법사 페이지의 PROPSHEETPAGE 구조에 마법사 97 헤더 제목과 헤더 부제목을 제공해야 합니다. 설치 관리자가 시스템 제공 마법사 제목을 바꾸면 안 됩니다. PROPSHEETPAGE 구조에 대한 설명서와 속성 페이지에 대한 자세한 내용은 Microsoft Windows SDK 참조하세요.

DIF 코드에 대한 자세한 내용은 DIF 코드 처리를 참조하세요.