UMDF에서 디바이스 유휴 및 절전 모드 해제 동작의 사용자 제어

경고

UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다.

보관된 UMDF 1 샘플은 Windows 11 버전 22H2 - 2022년 5월 드라이버 샘플 업데이트에서 찾을 수 있습니다.

자세한 내용은 UMDF를 사용하여 시작 참조하세요.

디바이스에 유휴 전원 또는 절전 모드 해제 기능이 있는 경우 사용자가 이러한 기능을 사용하거나 사용하지 않도록 설정할 수 있는지 여부를 결정할 수 있습니다.

UMDF 기반 드라이버는 IWDFDevice2::AssignS0IdleSettings 메서드를 사용하여 레지스트리 액세스 권한이 있는 사용자가 디바이스의 유휴 전원 차단 기능을 사용하거나 사용하지 않도록 설정할 수 있는지 여부를 지정할 수 있습니다.

드라이버는 IWDFDevice2::AssignSxWakeSettings 메서드를 사용하여 레지스트리 액세스 권한이 있는 사용자가 디바이스의 절전 모드 해제 기능을 사용하거나 사용하지 않도록 설정할 수 있는지 여부를 지정할 수 있습니다.

이러한 두 메서드를 모두 사용하면 드라이버가 기능을 사용하도록 설정하거나, 기능을 사용하지 않도록 설정하거나, 사용자에게 기능을 제어할 수 있습니다.

• 드라이버가 AssignS0IdleSettings 메서드를 호출하면 UserControlOfIdleSettings 매개 변수를 IdleAllowUserControl 로 설정하고 Enabled 매개 변수를 WdfTrue 또는 WdfUseDefault로 설정하여 사용자에게 디바이스의 유휴 기능을 제어할 수 있습니다.

• 드라이버가 AssignSxWakeSettings 메서드를 호출할 때 UserControlOfWakeSettings 매개 변수를 WakeAllowUserControl 로 설정하고 Enabled 매개 변수를 WdfTrue 또는 WdfUseDefault로 설정하여 사용자에게 디바이스의 절전 모드 해제 기능을 제어할 수 있습니다.

드라이버에서 사용자가 유휴 및 절전 모드 해제 설정을 수정할 수 있는 경우 프레임워크는 사용자가 유휴 및 절전 모드 해제 기능을 사용하거나 사용하지 않도록 설정할 수 있도록 장치 관리자 표시되는 속성 시트 페이지의 형태로 사용자 인터페이스를 제공합니다. (프레임워크는 IdleInWorkingState 및 WakeFromSleepState 레지스트리 값을 수정합니다. 드라이버와 해당 설치 파일은 이러한 값을 읽거나 수정해서는 안 됩니다.)

사용자가 디바이스 설정을 수정하는 경우 프레임워크는 필요한 경우 새 설정과 일치하도록 디바이스의 전원 상태를 업데이트합니다. 예를 들어 디바이스가 유휴 상태이기 때문에 디바이스가 이미 저전력 상태인 동안 사용자가 디바이스의 유휴 전원 다운 기능을 사용하지 않도록 설정하면 프레임워크는 디바이스를 작동 상태로 반환합니다.

드라이버에서 사용자가 유휴 및 절전 모드 해제 설정을 수정할 수 있도록 허용하는 경우 프레임워크는 기본적으로 이러한 설정을 사용하도록 설정합니다. 일부 드라이버 작성기는 사용자가 설정을 수정할 수 있도록 허용하기 전에 처음에 설정을 사용하지 않도록 설정할 수 있습니다.

따라서 프레임워크 버전 1.9 이상은 디바이스의 하드웨어 키 아래에 디바이스의 디바이스 매개 변수\WDF 하위 키에 저장된 WdfDefaultIdleInWorkingState 및 WdfDefaultWakeFromSleepState라는 두 개의 드라이버 정의 가능한 레지스트리 값을 제공합니다. 값은 REG_DWORD 형식이며, "0"은 기능이 비활성화되었음을 나타내고 "1"은 기능이 사용하도록 설정되어 있음을 나타냅니다.

드라이버의 INF 파일은 INF AddReg 지시문을 사용하여 WdfDefaultIdleInWorkingState 및 WdfDefaultWakeFromSleepState 레지스트리 값을 만들고 설정할 수 있습니다. 예를 들어 드라이버가 디바이스의 유휴 전원 다운 기능을 사용하도록 설정하지만 디바이스를 설치할 때 기능을 사용하지 않도록 설정해야 하는 경우 드라이버의 INF 파일은 WdfDefaultIdleInWorkingState 를 "0"으로 설정할 수 있습니다.

프레임워크는 드라이버가 UserControlOfIdleSettings 매개 변수를 IdleAllowUserControl로 설정하고 Enabled 매개 변수를 드라이버가 IWDFDevice2::AssignS0IdleSettings 메서드를 호출할 때 WdfTrue 또는 WdfUseDefault로 설정하는 경우에만 WdfDefaultIdleInWorkingState 레지스트리 값을 검사합니다.

프레임워크는 드라이버가 IWDFDevice2::AssignSxWakeSettings 메서드를 호출할 때 UserControlOfWakeSettings 매개 변수를 IWakeAllowUserControl로 설정하고 Enabled 매개 변수를 WdfTrue 또는 WdfUseDefault로 설정하는 경우에만 WdfDefaultWakeFromSleepState 레지스트리 값을 검사합니다.