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

# 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](https://docs.xbox.com/reference/remoting/enums/wdlaunchmode.md)**

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](https://docs.xbox.com/reference/remoting/functions/wdlaunchremotegame.md) 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](https://docs.xbox.com/reference/remoting/functions/wdlaunchremotegame.md)
* [WdLaunchMode](https://docs.xbox.com/reference/remoting/enums/wdlaunchmode.md)
* [XBOX PC Remote Iteration API](https://docs.xbox.com/reference/remoting/remoteiteration_members.md)


## Related topics

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