DIF_PROPERTYCHANGE

아티클
06/15/2023

DIF_PROPERTYCHANGE 요청은 설치 관리자에게 디바이스의 속성이 변경되고 있음을 알 수 있습니다. 디바이스를 사용하도록 설정, 비활성화, 시작, 중지 또는 속성 페이지의 일부 항목이 변경되었습니다. 이 DIF 요청은 설치 관리자에게 변경에 참여할 수 있는 기회를 제공합니다.

보낸 경우

디바이스를 사용하도록 설정, 사용 안 함, 다시 시작, 중지 또는 해당 속성이 변경된 경우

예를 들어 Windows는 속성 페이지 공급자가 디바이스에 대한 SP_DEVINSTALL_PARAMS 구조의 FlagsEx 필드에서 DI_FLAGSEX_PROPCHANGE_PENDING 플래그를 설정하는 경우 이 요청을 보냅니다.

디바이스가 처음 시작되거나 이후에 다시 시작되는 시기를 감지하는 방법에 대한 자세한 내용은 설치 관리자 작업 섹션을 참조하세요.

처리할 사람

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

설치 관리자 입력

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

DeviceInfoData
디바이스 정보 집합의 디바이스에 대한 SP_DEVINFO_DATA 구조에 대한 포인터를 제공합니다.

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

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

설치 관리자 출력

없음

설치 관리자 반환 값

공동 설치 관리자는 NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED 또는 Win32 오류 코드를 반환할 수 있습니다.

클래스 설치 관리자가 이 요청을 성공적으로 처리하고 SetupDiCallClassInstaller 가 이후에 기본 처리기를 호출해야 하는 경우 클래스 설치 관리자는 ERROR_DI_DO_DEFAULT 반환합니다.

클래스 설치 관리자가 기본 처리기를 직접 호출하는 것을 포함하여 이 요청을 성공적으로 처리하는 경우 클래스 설치 관리자는 NO_ERROR 반환해야 하며 SetupDiCallClassInstaller 는 이후에 기본 처리기를 다시 호출하지 않습니다.

참고 클래스 설치 관리자는 기본 처리기를 직접 호출할 수 있지만 클래스 설치 관리자는 기본 처리기의 작업을 대체하려고 시도해서는 안 됩니다.

기본 처리기를 호출하는 방법에 대한 자세한 내용은 기본 DIF 코드 처리기 호출을 참조하세요.

클래스 설치 관리자에 오류가 발생하면 설치 관리자는 적절한 Win32 오류 코드를 반환해야 하며 SetupDiCallClassInstaller 는 이후에 기본 처리기를 호출하지 않습니다.

기본 DIF 코드 처리기

SetupDiChangeState

설치 관리자 작업

DIF_PROPERTYCHANGE 요청에 대한 응답으로 설치 관리자는 속성 변경 작업에 참여할 수 있습니다. 클래스 설치 매개 변수(SP_PROPCHANGE_PARAMS)는 어떤 변경이 일어나고 있는지를 나타냅니다.

속성을 변경하려면 시스템을 다시 시작해야 할 수 있습니다. 시스템을 다시 시작하는 방법에 대한 자세한 내용은 SetupDiCallClassInstaller를 참조하세요.

Windows에서 처음으로 디바이스를 설치하라는 DIF_INSTALLDEVICE 요청을 보내면 Windows는 디바이스를 시작하지만 설치의 일부로 DIF_PROPERTYCHANGE 요청을 보내지 않습니다. 디바이스를 처음 시작할 때와 이후에 디바이스를 다시 시작할 때마다 사용자 지정 설치 작업을 수행해야 하는 경우 설치 관리자 또는 공동 설치 관리자는 처음으로 디바이스를 시작하는 DIF_INSTALLDEVICE 요청과 상태 변경 작업이 디바이스가 시작되고 있음을 나타내는 DIF_PROPERTYCHANGE 요청을 처리해야 합니다.

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