Skip to main content

WdLaunchRemoteGame

원격 기기에서 게임을 실행합니다.

구문

매개 변수

_In_z_ remoteDevice
형식: const char*
원격 기기의 호스트 이름 또는 IP 주소입니다(예: "192.168.1.100" 또는 "MyDevKit"). _In_z_ remotePath
형식: const char*
원격 기기에서 게임 실행 파일의 경로입니다. 절대 경로(예: "D:\\Games\\MyGame\\game.exe")이거나 공통 루트를 기준으로 확인되는 상대 경로(예: "MyGame\\game.exe")일 수 있습니다. _In_opt_z_ args
형식: const char*
선택 사항. 게임 실행 파일에 전달할 명령줄 인수입니다(예: "-windowed -debug"). 인수가 필요 없으면 nullptr을 전달하세요. _In_opt_ launchOptions
형식: WdLaunchOptions*
선택 사항. 실행 모드와 공통 루트 별칭을 지정합니다. 기본 설정(Immediate 실행, 기본 공통 루트)을 사용하려면 nullptr을 전달하세요. _Out_opt_ processId
형식: uint32_t*
선택 사항. 실행된 게임의 프로세스 ID를 받습니다. 프로세스 ID가 필요 없으면 nullptr을 전달하세요. _Out_opt_ threadId
형식: uint32_t*
선택 사항. 실행된 게임의 메인 스레드의 스레드 ID를 받습니다. 스레드 ID가 필요 없으면 nullptr을 전달하세요.

반환 값

형식: HRESULT 성공 시 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

오류 코드

설명

원격 기기에서는 한 번에 하나의 게임 프로세스만 실행할 수 있습니다. 게임이 이미 실행 중이면 이 함수는 자동으로 종료한 후 다시 실행합니다. 새 게임을 실행하기 전에 WdTerminateRemoteGame을 사용하여 기존 게임을 종료할 수 있습니다. WdLaunchMode::Suspended로 실행하면 게임 프로세스가 일시 중단 상태로 시작됩니다. 실행을 재개하려면 WdResumeRemoteGame을 사용하세요. 게임이 실행을 시작하기 전에 디버거를 연결하는 데 유용합니다.

예제

예제 1: 원격 기기에서 게임 실행

기본 설정(즉시 실행, 기본 공통 루트)을 사용하여 이전에 복사된 게임 실행 파일을 실행합니다.

예제 2: 디버깅을 위한 일시 중단 모드 실행

디버거가 실행 시작 전에 연결될 수 있도록 게임을 일시 중단 상태로 실행합니다. 디버거가 연결된 후 사용자가 Enter 키를 눌러 프로세스를 재개합니다.

예제 3: 복사 및 실행 워크플로

일반적인 반복 주기를 보여줍니다: 원격 기기로 게임 파일을 복사한 다음 실행 파일을 실행합니다. XBOX PC Remote Iteration API에서 가장 일반적인 종단 간 워크플로입니다.

요구 사항

함께 보기

마지막 수정일 2026년 8월 24일