# VDD 연결 실패 · 사전 검사와 빌드 준비 현재 Ubuntu 실측·앱 통합·남은 조건은 [VDD_HOST_INTEGRATION.ko.md](VDD_HOST_INTEGRATION.ko.md)와 [소스 확인 기록](evidence/vdd-ubuntu-source-audit.json)을 따른다. 요청한 소스 5개는 main에 있고 보관 EXE의 SHA-256도 설치본 보고와 일치한다. 아래 내용은 해당 확인 전 Windows 작업 당시의 조사·검증 기록으로 보존한다. 확인일: 2026-10-02. 대상: F39/F48/F49, `host_virtual_monitors`, `host_privacy_mode`, `host_virtual_monitor_fallback`. 이 기록은 기능 완성 또는 Parsec 일치 판정이 아니다. ## 재현 보고와 현재 한계 사용자는 원격 연결 시 `상대 PC GPU 초기화 실패: notParsec VDD가 준비되지 않았습니다` 오류를 보고했다. Virtual Displays=0, Privacy=끔, Fallback=끔으로 설정한 뒤 연결 성공을 확인했다. 따라서 VDD 경로가 실패에 관여하지만 대상 PC의 topology와 해당 실행 로그가 없어 정확한 내부 원인은 미확정이다. 이 PC의 `C:\notparsec\notparsec.exe`는 build `1790649305`, embedded commit `9aa8b7382b97ee65a3e9f178843b276cd5382084`, SHA-256 `8c0f95e1e1055803b001a2231dc021c3a5c52f0c88e3ff4c9173b3f890127d76`이다. 바이너리에는 `crates/updater`, VDD, GPU handshake `/10` 관련 문자열과 현재 Git에 없는 소스 경로가 있다. 이는 설치 EXE와 Git의 소스 대응이 미확인이라는 근거이며, Ubuntu에 미커밋 소스가 존재한다는 증거는 아니다. 기존 SSH 키 인증 실패로 해당 폴더의 상태는 확인하지 못했다. **2026-10-02 정정:** 사용자는 로컬 내용을 모두 Git에 커밋했다고 알렸다. 재검사한 Windows 작업 폴더에는 미커밋 변경이 없고 fetch 후 로컬·원격 main은 `0af8fa6`으로 일치했다. `/home/ahn/notparsec` 문자열만으로 그곳에 최신 미커밋 소스가 있다고 단정해 선행 조건으로 삼은 판단을 철회한다. [재검사 근거](evidence/source-reconciliation.json). 현재 main을 개발 기준으로 계속 진행하며, 기존 설치본을 직접 교체·재사용하는 단계에서는 출처와 기능 대응을 별도로 검증한다. ## 원본 근거와 재작성의 경계 Parsec Windows 150-104a, 코어 SHA-256 `8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f`를 기준으로 한다. | 원본 근거 | 확인 가능한 내용 | 이번 구현/판정 | |---|---|---| | [설정 테이블](../analysis/parsec/research/settings/settings-evidence.json), `0x180341810`/`0x180342790`/`0x180343520` | 가상 화면 수 기본 0, Privacy 기본 false, fallback 기본 true | Rust `DisplayRequest` 기본값. 설치본의 모든 런타임 조건이 복구됐다는 뜻은 아님 | | [UI 의사 코드](../analysis/parsec/decompiled/parsecd-150-104a.dll/retry-decompiled.c), `180012c50`, 약 3110–3236행 | 다른 디스플레이가 없을 때 단일 가상 출력 추가, 드라이버 미설치 표시 | 물리 출력이 있으면 fallback만으로 VDD를 열지 않는 순수 함수·회귀 시험 | | [설정·Privacy 분석](SETTINGS_AND_RECOVERY.ko.md) | Privacy가 가상 화면을 필요로 하며 물리 출력 변경·복원이 수반됨 | 드라이버가 없으면 Privacy 요구를 실패로 유지. 실제 topology 변경·복구는 아직 구현/검증하지 않음 | | [VDD 추가 의사 코드](../analysis/parsec/decompiled/focus/vdd_monitor_add__180002e20.c), `mm.dll!180002e20` | 원본 VDD의 모니터 추가 경계 | notParsec의 IOCTL/ABI를 이 함수와 동일하다고 주장하지 않음 | `display_requirements.rs`는 독립 Rust 코드다. 원본 소스나 빌드 가능한 복구 코드가 아니다. 오류 enum과 lazy probe API는 자체 구현용 구조이며 원본 내부 상태 이름으로 취급하지 않는다. E03/E04 범위의 기반 작업이고 원본 화면·동작 대조 전이므로 parity는 `unreviewed`를 유지한다. ## 구현한 사전 검사 - 물리 화면이 있으면 기본 fallback=true여도 드라이버 probe를 호출하지 않는다. - 물리 출력이 없고 fallback=true면 가상 화면 1개와 준비된 드라이버가 필요하다. - topology 조회 실패를 모니터 없는 PC로 오인하지 않는다. - Privacy 또는 명시한 가상 화면 요구는 드라이버가 없을 때 물리 공유로 몰래 바뀌지 않는다. - 드라이버의 0개 지원 응답과 지원 개수 초과를 거부한다. - 설치 파일의 존재만으로 `Ready`로 판정하지 않는다. 실제 인터페이스 호환 응답을 검사하는 호출부가 필요하다. **현재 배포 앱의 VDD 연결 경로에는 아직 통합되지 않았다.** Windows 활성 화면 조회는 아래 후속 작업으로 추가했지만 VDD 장치 조회·가상 모니터 생성·설정 UI 변경·installer는 아직 없다. 사전 검사 통과는 가상 캡처 검증 또는 물리 모니터 끄기 허가를 뜻하지 않는다. ## 후속 구현: 실제 활성 화면 조회 [display_topology.rs](../crates/platform-win/src/display_topology.rs)는 Microsoft의 CCD API로 현재 데스크톱의 활성 경로를 읽는다. 드라이버 ABI와 독립적인 E03 기반 구현이며 Parsec 내부 구현과 동일하다고 주장하지 않는다. - `GetDisplayConfigBufferSizes` → `QueryDisplayConfig`, `QDC_ONLY_ACTIVE_PATHS | QDC_VIRTUAL_MODE_AWARE`를 사용한다. 설정된 데이터베이스의 과거 배치가 아닌 현재 활성 경로를 읽는다. - 버퍼 크기 변경 또는 일시적으로 사용 불가한 활성 경로는 최대 4회 재조회한다. 이 횟수는 자체 구현 제한이며 원본에서 복구한 상수가 아니다. - 권한/세션 오류·지원 불가·계속되는 구성 변경은 오류로 유지한다. 빈 결과로 바꾸거나 headless로 추정하지 않는다. 0개도 실제 조회 성공이 필요하다. - 어댑터 LUID와 target ID 쌍으로 활성 화면을 세므로 복제 소스·다중 GPU·중복 경로를 구분한다. 이미 활성인 가상 화면도 포함한다. `DisplayPlan::ExistingOutputs`는 물리 화면만을 의미하지 않는다. - Session 0/RDP 및 다른 사용자의 데스크톱을 대신 조회하지 않는다. 조회 성공이 영상 캡처 성공을 보장하지 않으며 화면 변경 직전에는 다시 조회해야 한다. 개발용 진단 도구에서 실행한다. 제품 사용자용 EXE가 추가된 것이 아니며 기존 `apps/diagnostics`에 명령을 추가했다. ```powershell cargo run -p notparsec-diagnostics --locked -- display-topology ``` 이 Windows PC에서 활성 target 3개(DisplayPort 2, HDMI 1)를 확인했다. 원격 대상 PC를 측정한 결과가 아니며 화면 비활성화·설치·기존 EXE 교체는 수행하지 않았다. [실기 조회 결과와 소스 해시](evidence/display-topology-live.json)를 보존했다. 활성 화면 query는 현재 진단 도구에서만 호출되며 배포 앱에는 아직 연결되지 않았다. 사전 검사 5개와 topology 7개(재시도, 오류 보존, 복제/다중 어댑터, 0개 성공, 일시적으로 사용 불가한 경로, 이미 활성인 가상 화면의 fallback) 회귀 시험을 추가했다. headless·hotplug·RDP의 실제 환경과 원본 비교는 남아 있다. ## 빌드와 검증 결과 - 사전 검사 회귀 시험 5개 통과. 입력 상태별 VDD probe 호출 여부, privacy 실패 유지, capacity 경계를 검사한다. - `cargo clippy -p notparsec-platform-win --all-targets --locked -- -D warnings` 통과. 문서/진행표 Node 시험 25개 통과. 이 결과들은 실제 가상 화면 동작 시험을 포함하지 않는다. - Microsoft WDK NuGet 10.0.26100.1을 `.tools/vdd`에 준비했다. SDK 10.0.26100.0 / MSVC 14.42.34433에서 고정 Microsoft IDD 샘플을 x64 DLL로 컴파일·링크했다. - 결과 DLL은 unsigned sample probe다. notParsec 호환 드라이버, 설치 가능한 배포물, 실제 디스플레이 동작 검증 결과가 아니다. - `toolchain_probe.py prepare`의 캐시 입력 해시 검사·압축 해제 경로도 실행했다. 다운로드 도구·압축파일·샘플 소스·생성 DLL은 Git 제외 경로에만 있다. - [실행 근거](evidence/vdd-readiness.json), [빌드 입력 해시](../drivers/vdd/build-inputs.json), [재현 절차](../drivers/vdd/README.ko.md). - 드라이버 설치, 장치 등록, 인증서 신뢰 추가, 부팅 정책 변경, Privacy 출력 차단, 실행 중인 EXE 교체를 수행하지 않았다. ## 다음 구현 브랜치 정리 후 `main`에서 계속한다. [빌드 소스 추적과 출처 대조](BUILD_SOURCE_PROVENANCE.ko.md)의 CI 검증은 향후 소스 기록을 위한 장치다. 과거 설치본이 미커밋 소스로 빌드됐음을 증명하거나 별도의 Ubuntu 소스를 요구하는 근거로 사용하지 않는다. 현재 main의 실제 VDD 미구현 범위 확인 → 원본 근거와 E03에 따른 앱·드라이버 책임/계약 검토 → VDD 구현 → 서명·INF/CAT 패키지 확인 → 관리자 설치/장치 등록/제거 → 같은 main 빌드의 앱 readiness/설정 UI/연결 경로 통합 → 실제 모니터 있는/없는 PC와 Privacy 종료·강제 종료·재부팅 복구 시험. 출처 미확인 설치본의 HWID/GUID/IOCTL을 추정해서 호환이라고 표시하지 않는다. F39/F48/F49는 완료 처리하지 않는다. 참고한 플랫폼 자료: - [Microsoft IDD 개요](https://learn.microsoft.com/en-us/windows-hardware/drivers/display/indirect-display-driver-model-overview) - [공식 IDD 샘플의 고정 커밋](https://github.com/microsoft/Windows-driver-samples/tree/d5569c08aa2818c6240744bb47a00f67f20fdb54/video/IndirectDisplay) — MIT, 컴파일 환경 검증에만 사용 - [WDK NuGet](https://learn.microsoft.com/en-us/windows-hardware/drivers/install-the-wdk-using-nuget) - [Windows 드라이버 서명](https://learn.microsoft.com/en-us/windows-hardware/drivers/install/driver-signing) - [Windows QueryDisplayConfig](https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-querydisplayconfig) — API 사용 근거이며 Parsec 구현 근거와 구분