notParsec / 문서전체 문서

설명·설계 문서

Windows 자동 화면 꺼짐 뒤 첫 영상 복구

design/DISPLAY_WAKE_RECOVERY.ko.md

출처: 현재 작업 폴더 · 원문 다운로드

이 문서의 목차

2026-10-02 · progress-49 · F07/F10/F24 · 부분 구현, Windows 실기 확인 대기

사용자 조건과 확인한 결함

사용자는 Windows에서 자동으로 화면만 꺼진 상태에서 신규 연결이 Waiting for video에 머문다고 보고했다. 호스트 빌드 1790965245 업데이트와 Windows 재시작도 완료했다고 확인했다. 이전 서비스가 계속 실행 중이라는 가정을 원인으로 사용하지 않는다. 원격 PC의 실제 API 오류 로그와 GPU 상태는 아직 확보하지 못했다.

소스에서는 다음을 확인했다.

  1. 인증된 캡처 스레드가 SetThreadExecutionState를 호출하지만, 보관한 Parsec의 별도 화면 켜기 메시지는 없었다.
  2. DXGI 복구가 기존 출력 객체를 재사용했다. 첫 프레임 전 WAIT_TIMEOUT이 이어질 때 출력 목록을 새로 조회하지 않았다.
  3. GPU 초기화 오류는 바깥 문구만 전달했다. Ready 이후 캡처 오류는 상세 사유 없이 스트림 종료로 바뀌었고, UI 오류 표시도 HTTP 세션 정리가 끝날 때까지 늦어질 수 있었다.

이는 확인한 코드 결함이다. 사용자 PC에서 어느 경로가 발생했는지 또는 이 수정으로 실제 문제가 해결됐는지는 Windows 재시험으로 확인해야 한다.

원본 근거와 구현 대응

기준은 Windows Parsec 150-104a, 코어 SHA-256 8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f다. 발췌·해시 기록은 보관한 바이너리 해시를 실측했고, Ghidra 의사 코드와 독립 Rust 재작성을 구분한다.

근거 확인한 동작 notParsec 대응과 제한
1800a65e0, 1800ad060 호스트 초기화 조건에서 SC_MONITORPOWER(-1) 메시지 display_power.rs: 인증 뒤 입력 데스크톱에 연결한 스레드에서 1회 비동기 요청. Privacy는 제외
1800443a0 새 factory·어댑터·출력에서 duplication 생성 gpu_video.rs: 초기 전환 재시도와 첫 프레임 복구에서 새 DXGI 조회. 기존 LUID·화면 ID·크기·회전을 검사
180044740, 180044850 캡처 초기화/정리와 화면 전원 요청 수명 기존 세션 전원 요청과 해제 유지. 전원 정책·잠금 상태 변경 없음
기존 자체 전송·UI 원본 wire/오류 문구 대응 미확인 session/remote.rs, desktop-ui/app/remote_ui.rs: 원인 전달과 오류 표시 시점 교정. parity different 유지

SetThreadExecutionState(ES_DISPLAY_REQUIRED) 자체도 화면 유휴 시간을 재설정하고 화면 켜기를 요청한다. 이 API가 화면을 깨울 수 없다고 단정하지 않는다. 이번 수정은 원본에서 확인한 별도 시작 절차의 누락과 DXGI 재생성 결함을 보완한다. Microsoft API 설명

구현 수명과 실패 처리

1/3/30/35초는 독립 구현의 제한이며 원본에서 복구한 상수가 아니다. 동기 Windows API 자체가 반환하지 않는 상황까지 이 시간 안에 종료한다고 보장하지 않는다. VDD 준비 상태·Privacy 복구·GPU 코덱 선택·입력·업데이트의 기존 계약은 유지한다. 서명된 VDD 설치나 Privacy 실기 완료로 세지 않는다.

Windows에서 확인할 순서

  1. 콘솔 다운로드의 새 Windows EXE로 호스트와 접속 PC를 갱신한다. 새 호스트 앱의 Settings → Host → Windows Hosting Service → 호스팅 서비스 설치/업데이트를 실행한다. 서비스가 이미 설치됐어도 새 서비스 코드 반영에 필요하다.
  2. 진행 중인 원격 연결을 종료한 뒤, 호스트의 로컬 관리자 PowerShell에서 실행한다. 앱이 실제 설치된 위치로 $App을 맞춘다.
$App = 'C:\notparsec\notparsec.exe'
Get-FileHash $App -Algorithm SHA256
Restart-Service notParsec
Get-CimInstance Win32_Service -Filter "Name='notParsec'" | Select-Object Name,State,StartName,PathName
Get-Content "$env:ProgramData\notParsecService\service-version.json"
Get-Content "$env:ProgramData\notParsecService\status.json"
powercfg /query SCHEME_CURRENT SUB_VIDEO VIDEOIDLE
  1. 기존 자동 화면 꺼짐 설정을 그대로 두고 Virtual Displays=0, Privacy=Off, Fallback=Off에서 화면이 자동으로 꺼질 때까지 기다린다. 호스트를 직접 조작하지 말고 다른 PC에서 연결한다. 첫 영상 도착 시간·물리 화면 복귀·입력 동작을 기록한다. 실패하면 표시된 전체 오류와 위 status.json을 즉시 저장한다.
  2. 활성 물리 화면이 있는 동일 조건에서 Fallback=On도 확인한다. 이후 Win+L 잠금 후 신규 연결, 연결 중 잠금/해제, 정지 화면 유지, 종료 후 다시 자동 화면 꺼짐을 별도 시험한다. Privacy와 모니터 물리 전원 버튼은 별도 조건이다.

추가 GPU 분리 진단은 & $App video-probe --seconds 10 --codec h264다. 이 명령은 RemoteDesktop의 전원·서비스 준비를 우회하므로 성공해도 위 원격 연결 시험을 대신하지 않는다. 업데이트에는 콘솔의 동일한 notparsec.exe만 필요하며 이 문제를 확인하려고 VDD 패키지를 설치할 필요는 없다.

검증 기록

기계 판독 기록에 실제 실행한 Linux 회귀·Windows 교차 검사·릴리스와 콘솔 게시 결과를 기록한다. Windows 자동 화면 꺼짐·잠금·실제 영상·입력·동일 조건 Parsec 대조는 미실행이며 완료로 표시하지 않는다.

배포 전 검사: 관련 Rust 회귀 118개 통과·실제 OS 클립보드 1개 제외, Linux session/UI 및 Windows 전체 앱 Clippy, 문서 Python 6개·Node 31개와 형식 검사가 통과했다. 인증·정상 영상 순서/입력·설정 변경·접속 해제, 첫 프레임 전 실패 원인 전달을 포함한다. Windows 릴리스와 콘솔 게시도 완료했다.

게시한 Windows 파일

공개 문서 사이트는 이번 작업에서 게시하지 않았다. 이 기록과 생성 HTML은 저장소에 반영했다. 실제 Windows 자동 화면 꺼짐 복구는 새 빌드로 확인해야 한다.