> ## 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.

# XtfStartTitleOSByGameConfig

> XtfStartTitleOSByGameConfig

# XtfStartTitleOSByGameConfig

Starts or restarts the Game OS based on the contents of a MicrosoftGame.config file that is stored in memory as a string.

<a id="syntaxSection" />

## Syntax

```cpp theme={null}
HRESULT XtfStartTitleOSByGameConfig(
         PCWSTR address,
         UINT32 flags,
         PCWSTR gameconfigContents
)  
```

<a id="parametersSection" />

### Parameters

*address*\
Type: PCWSTR

\[in] The IP address of the console.

*flags*\
Type: UINT32

\[in] Currently unused, but reserved for future behavior changes.

*gameconfigContents*\
Type: PCWSTR

\[in] The contents of a MicrosoftGame.config file.

<a id="retvalSection" />

### Return value

Type: HRESULT

Returns `S_OK` if successful; otherwise, returns an error code.

<a id="remarksSection" />

## Remarks

Use this function to start or restart the game OS based on the contents of a MicrosoftGame.config file that is stored in memory as a string. If a value for `address` or `gameconfigContents` isn't specified, an error occurs.

For more information about the contents of a MicrosoftGame.config file, see [MicrosoftGame.config Overview](/build/core-features/common/game-config/MicrosoftGameConfig-Overview).

<a id="requirements" />

## Requirements

**Header:** xtfapi.h

**Library:** XtfApi.lib

**Supported platforms:** Windows (for XBOX console tools)

<a id="seealsoSection" />

## See also

[XTF Transport Errors (NDA topic)](/tools/tools-console/commandlinetools/xtf-transport-errors)\
[Additional Xtf APIs](/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfStartTitleOS](/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md)
- [XtfStartTitleOSByVersion](/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m.md)
- [XtfCacheTitleOS](/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m.md)
- [XtfRemoveTitleOSFromCache](/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcache-xtfapi-xbox-windows-m.md)
- [XtfCaptureRecordedGameClip](/reference/tools/xtf/xtfapi/functions/xtfcapturegameclip-xbox-microsoft-m.md)