다음을 통해 공유


DIF_POWERMESSAGEWAKE

DIF_POWERMESSAGEWAKE 요청을 사용하면 설치 관리자가 디바이스 속성의 전원 관리 속성 페이지에 Windows가 표시하는 사용자 지정 텍스트를 제공할 수 있습니다.

보낸 경우

사용자가 메뉴 항목 또는 탭을 클릭하여 디바이스의 속성을 표시하는 경우

Windows는 디바이스용 드라이버가 전원 관리를 지원하는 경우에만 이 DIF 요청을 보냅니다. 그렇지 않으면 Windows에서 디바이스에 대한 전원 속성을 표시하지 않습니다.

처리할 사람

클래스 공동 설치 관리자

처리 가능

디바이스 공동 설치 관리자

처리 가능

클래스 설치 관리자

처리 가능

설치 관리자 입력

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

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

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

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

설치 관리자 출력

클래스 설치 매개 변수
설치 관리자는 디바이스의 전원 속성 페이지에 대한 사용자 지정 텍스트를 제공하도록 SP_POWERMESSAGEWAKE_PARAMS 수정할 수 있습니다.

설치 관리자 반환 값

공동 설치 관리자는 일반적으로 NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED 또는 Win32 오류 코드를 반환합니다.

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

기본 DIF 코드 처리기

없음

설치 관리자 작업

DIF_POWERMESSAGEWAKE 요청을 사용하면 설치 관리자가 Windows가 디바이스의 전원 속성 페이지에 표시하는 텍스트를 제공할 수 있습니다.

공동 설치 관리자가 전원 속성 텍스트를 제공하는 경우 후처리 단계에서 이 작업을 수행해야 합니다. 공동 설치 관리자는 공동 설치 관리자 전에 요청을 처리한 설치 관리자가 제공한 전원 속성 텍스트를 덮어쓸 때 주의해야 합니다.

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

요구 사항

Version

Microsoft Windows 2000 이상 버전의 Windows에서 지원됩니다.

헤더

Setupapi.h(Setupapi.h 포함)

추가 정보

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SP_POWERMESSAGEWAKE_PARAMS