DIF_ADDPROPERTYPAGE_ADVANCED
DIF_ADDPROPERTYPAGE_ADVANCED 요청을 사용하면 설치 관리자가 디바이스에 대해 하나 이상의 사용자 지정 속성 페이지를 제공할 수 있습니다.
보낸 경우
사용자가 장치 관리자 또는 제어판 디바이스의 속성을 클릭할 때
Who 핸들
클래스 공동 설치 관리자 |
처리 가능 |
디바이스 공동 설치 관리자 |
처리 가능 |
클래스 설치 관리자 |
처리 가능 |
설치 관리자 입력
DeviceInfoSet
디바이스가 포함된 디바이스 정보 집합 에 핸들을 제공합니다.
DeviceInfoData
필요에 따라 디바이스 정보 집합에서 디바이스를 식별하는 SP_DEVINFO_DATA 구조에 대한 포인터를 제공합니다. DeviceInfoSet이 NULL인 경우 Windows 디바이스 설정 클래스에 대한 속성 페이지를 요청합니다.
디바이스 설치 매개 변수
디바이스 설치 매개 변수(SP_DEVINSTALL_PARAMS)는 DeviceInfoData(지정된 경우) 또는 DeviceInfoSet과 연결됩니다.
클래스 설치 매개 변수
SP_ADDPROPERTYPAGE_DATA 구조체는 DeviceInfoData(지정된 경우) 또는 DeviceInfoSet과 연결됩니다.
설치 관리자 출력
디바이스 설치 매개 변수
설치 관리자는 디바이스 설치 매개 변수를 수정할 수 있습니다.
클래스 설치 매개 변수
설치 관리자는 사용자 지정 페이지를 제공하기 위해 SP_ADDPROPERTYPAGE_DATA 수정할 수 있습니다.
설치 관리자 반환 값
공동 설치 관리자는 NO_ERROR 또는 Win32 오류를 반환할 수 있습니다. 공동 설치 관리자는 이 DIF 요청에 대한 ERROR_DI_POSTPROCESSING_REQUIRED 반환해서는 안 됩니다.
클래스 설치 관리자는 페이지를 성공적으로 제공하면 NO_ERROR 반환합니다. 그렇지 않으면 클래스 설치 관리자는 ERROR_DI_DO_DEFAULT 또는 Win32 오류 코드를 반환합니다.
기본 DIF 코드 처리기
없음
설치 관리자 작업
이 DIF 요청에 대한 응답으로 설치 관리자는 사용자 지정 속성 페이지를 제공할 수 있습니다. 이 DIF 요청을 처리하면 클래스 설치 관리자 또는 공동 설치 관리자의 속성 페이지를 제공할 수 있으며 속성 페이지 공급자 역할을 하는 별도의 DLL이 필요하지 않습니다.
설치 관리자는 일반적으로 이 DIF 요청을 처리하여 새 디바이스별 또는 설치 클래스별 속성 페이지를 추가합니다. 설치 관리자는 시스템에서 제공하는 드라이버 속성 페이지, 리소스 속성 페이지 또는 디바이스의 전원 속성 페이지를 바꿀 수도 있습니다. 설치 관리자가 시스템 제공 페이지를 대체하는 경우 설치 관리자는 디바이스에 대한 디바이스 설치 매개 변수에 적절한 플래그를 설정해야 합니다.
DI_DRIVERPAGE_ADDED
설치 관리자가 드라이버 속성 페이지를 제공했습니다.
DI_RESOURCEPAGE_ADDED
설치 관리자가 리소스 속성 페이지를 제공했습니다.
DI_FLAGSEX_POWERPAGE_ADDED
설치 관리자가 전원 속성 페이지를 제공했습니다.
설치 관리자는 시스템에서 제공하는 일반 속성 페이지를 바꿀 수 없습니다.
Windows 하나의 드라이버 페이지, 하나의 리소스 페이지 및 디바이스에 대한 하나의 전원 페이지만 표시합니다. 이전 설치 관리자가 해당 유형의 페이지를 이미 제공한 경우 설치 관리자가 대체 시스템 페이지를 제공하지 않아야 합니다. 이 제약 조건은 비시스템 제공 속성 페이지에는 적용되지 않습니다.
공동 설치 관리자는 전처리 패스에 사용자 지정 페이지를 추가해야 합니다.
설치 관리자가 사용자가 디바이스를 제거하고 다시 시작해야 하는 Windows 속성을 설정할 수 있도록 허용하는 경우 설치 관리자는 DialogProc 루틴에서 디바이스 설치 매개 변수의 DI_FLAGSEX_PROPCHANGE_PENDING 플래그를 설정해야 합니다.
디바이스 속성 페이지를 제공하는 방법에 대한 자세한 내용은 디바이스 속성 페이지 제공을 참조하세요.
DIF 코드에 대한 자세한 내용은 DIF 코드 처리를 참조하세요.
요구 사항
Version |
Microsoft Windows 2000 이상 버전의 Windows 지원됩니다. |
헤더 |
Setupapi.h(Setupapi.h 포함) |