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

# XGameActivation

> XGameActivation

# XGameActivation

Reference material for XGameActivation APIs.

<Note>The **XGameActivation** APIs replace the deprecated [XGameProtocol](/reference/system/xgameprotocol/xgameprotocol_members) and [XGameInvite](/reference/system/xgameinvite/xgameinvite_members) APIs. New games should use **XGameActivation** for protocol activation, file activation, and game invite handling. For migration guidance, see [Remarks](#remarks).</Note>

## Functions

| Function                                                                                                             | Description                                              |
| -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback)                       | A callback an application defines for activation events. |
| [XGameActivationRegisterForEvent](/reference/system/xgameactivation/functions/xgameactivationregisterforevent)       | Registers a callback for activation events.              |
| [XGameActivationUnregisterForEvent](/reference/system/xgameactivation/functions/xgameactivationunregisterforevent)   | Unregisters a callback for activation events.            |
| [XGameActivationAcceptPendingInvite](/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite) | Accepts a pending game invite.                           |

## Structures

| Structure                                                                            | Description                                                            |
| ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------- |
| [XGameActivationInfo](/reference/system/xgameactivation/structs/xgameactivationinfo) | Contains the activation information passed to the activation callback. |

## Enumerations

| Enumeration                                                                        | Description                                     |
| ---------------------------------------------------------------------------------- | ----------------------------------------------- |
| [XGameActivationType](/reference/system/xgameactivation/enums/xgameactivationtype) | Specifies the type of activation that occurred. |

<a id="remarks" />

## Remarks

The **XGameActivation** APIs provide a unified callback mechanism for all forms of game activation, including protocol activation, file activation, and game invite handling. This replaces the need to separately register with [XGameProtocolRegisterForActivation](/reference/system/xgameprotocol/functions/xgameprotocolregisterforactivation) and [XGameInviteRegisterForEvent](/reference/system/xgameinvite/functions/xgameinviteregisterforevent).

### Migrating from XGameProtocol and XGameInvite

| Deprecated API                         | Replacement                                                                                                          |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `XGameProtocolRegisterForActivation`   | [XGameActivationRegisterForEvent](/reference/system/xgameactivation/functions/xgameactivationregisterforevent)       |
| `XGameProtocolUnregisterForActivation` | [XGameActivationUnregisterForEvent](/reference/system/xgameactivation/functions/xgameactivationunregisterforevent)   |
| `XGameInviteRegisterForEvent`          | [XGameActivationRegisterForEvent](/reference/system/xgameactivation/functions/xgameactivationregisterforevent)       |
| `XGameInviteUnregisterForEvent`        | [XGameActivationUnregisterForEvent](/reference/system/xgameactivation/functions/xgameactivationunregisterforevent)   |
| `XGameInviteRegisterForPendingEvent`   | [XGameActivationRegisterForEvent](/reference/system/xgameactivation/functions/xgameactivationregisterforevent)       |
| `XGameInviteUnregisterForPendingEvent` | [XGameActivationUnregisterForEvent](/reference/system/xgameactivation/functions/xgameactivationunregisterforevent)   |
| `XGameInviteAcceptPendingInvite`       | [XGameActivationAcceptPendingInvite](/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite) |

## Conceptual documentation

* [File type activation](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)
* [Receiving invites](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)
* [Sending invites](/services/xbox-services/multiplayer/invites/how-to/live-invites-send)
* [Invites overview](/services/xbox-services/multiplayer/invites/live-multiplayer-invites-overview)

## See also

[System API reference](/reference/system/gc-reference-system-toc)\
[Protocol activation](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/protocolactivation)\
[File type activation](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)


## Related topics

- [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback.md)
- [XGameActivationInfo](/reference/system/xgameactivation/structs/xgameactivationinfo.md)
- [XGameActivationType](/reference/system/xgameactivation/enums/xgameactivationtype.md)
- [XGameActivationRegisterForEvent](/reference/system/xgameactivation/functions/xgameactivationregisterforevent.md)
- [XGameActivationUnregisterForEvent](/reference/system/xgameactivation/functions/xgameactivationunregisterforevent.md)