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

# XGameActivation (API contents)

> XGameActivation

Reference material for XGameActivation APIs.

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

## Functions

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

## Structures

| Structure | Description |
| - | - |
| [XGameActivationInfo](https://docs.xbox.com/reference/system/xgameactivation/structs/xgameactivationinfo.md) | Contains the activation information passed to the activation callback. |

## Enumerations

| Enumeration | Description |
| - | - |
| [XGameActivationType](https://docs.xbox.com/reference/system/xgameactivation/enums/xgameactivationtype.md) | Specifies the type of activation that occurred. |

## 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](https://docs.xbox.com/reference/system/xgameprotocol/functions/xgameprotocolregisterforactivation.md) and [XGameInviteRegisterForEvent](https://docs.xbox.com/reference/system/xgameinvite/functions/xgameinviteregisterforevent.md).

### Migrating from XGameProtocol and XGameInvite

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

## Conceptual documentation

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

## See also

[System API reference](https://docs.xbox.com/reference/system/gc-reference-system-toc.md)\
[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](https://docs.xbox.com/reference/system/xgameactivation/functions/xgameactivationcallback.md)
- [XGameActivationInfo](https://docs.xbox.com/reference/system/xgameactivation/structs/xgameactivationinfo.md)
- [XGameActivationType](https://docs.xbox.com/reference/system/xgameactivation/enums/xgameactivationtype.md)
- [XGameActivationRegisterForEvent](https://docs.xbox.com/reference/system/xgameactivation/functions/xgameactivationregisterforevent.md)
- [XGameActivationUnregisterForEvent](https://docs.xbox.com/reference/system/xgameactivation/functions/xgameactivationunregisterforevent.md)