> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WdLaunchOptions

> WdLaunchOptions

# WdLaunchOptions

Specifies options for launching a game on a remote device.

## Syntax

```cpp theme={null}
struct WdLaunchOptions
{
    WdLaunchMode launchMode;
    const char* commonRootAlias;
};
```

### Members

`launchMode`\
Type: **[WdLaunchMode](/reference/remoting/enums/wdlaunchmode)**

The launch mode for the game. Use `WdLaunchMode::Immediate` to start the game immediately, or `WdLaunchMod::Suspended` to start it in a suspended state (useful for attaching a debugger before execution begins).

`commonRootAlias`\
Type: **const char\***

An optional common root alias. Pass `nullptr` to use the default alias.

## Remarks

Pass this structure to [WdLaunchRemoteGame](/reference/remoting/functions/wdlaunchremotegame) via the `launchOptions` parameter to control how the game is launched. If `nullptr` is passed for `launchOptions`, the game is launched immediately with no common root alias.

## Requirements

| Requirement                 | Value                |
| --------------------------- | -------------------- |
| **Header**                  | WdRemoteIteration.h  |
| **Library**                 | wdremoteapi.lib      |
| **Supported OS**            | Windows 11 and later |
| **Supported architectures** | x64, ARM64           |

## See also

* [WdLaunchRemoteGame](/reference/remoting/functions/wdlaunchremotegame)
* [WdLaunchMode](/reference/remoting/enums/wdlaunchmode)
* [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members)


## Related topics

- [WdLaunchMode](/reference/remoting/enums/wdlaunchmode.md)
- [WdLaunchRemoteGame](/reference/remoting/functions/wdlaunchremotegame.md)
- [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members.md)
- [XBOX PC Remote (wdRemote.exe)](/tools/tools-pc/commandlinetools/gr-wdRemote.md)
- [XBOX PC Remote Tools: March 2026 (2603) release notes](/tools/tools-pc/xbox-pc-remote-tools/release-notes/2603.md)