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

# XErrorSetCallback

> XErrorSetCallback

# XErrorSetCallback

Spécifie le rappel appelé lorsqu'une erreur se produit dans le système d'exploitation de jeu ou le runtime de jeu.

## Syntaxe

```cpp theme={null}
void XErrorSetCallback(  
         XErrorCallback* callback,  
         void* context  
)  
```

### Paramètres

*callback*   \_In\_\
Type : XErrorCallback\*

Pointeur vers le rappel défini par le jeu à appeler. Le passage de `nullptr` efface le rappel.

*context*   \_In\_\
Type : void\*

Pointeur de contexte pour le rappel.

### Valeur de retour

Type : void

## Remarques

<Note>Cette fonction ne peut pas être appelée sans risque sur un thread à durée critique. Pour plus d'informations, consultez [Threads à durée critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Utilisez cette fonction pour spécifier le rappel [XErrorCallback](/fr/reference/system/xerror/functions/xerrorcallback) de votre jeu que le système doit appeler si une erreur se produit, et la fonction [XErrorSetOptions](/fr/reference/system/xerror/functions/xerrorsetoptions) pour spécifier le comportement du jeu lorsqu'une erreur se produit dans le système d'exploitation de jeu ou le runtime de jeu.

L'exemple suivant montre comment définir les options d'erreur, définir un rappel d'erreur personnalisé et configurer ce rappel d'erreur personnalisé pour recevoir les notifications d'erreur du système.

```cpp theme={null}
bool CustomGameXErrorCallback(_In_ HRESULT hr, _In_ const char* msg, _In_ void* context)  
{  
   // Capture the error to the game's custom logger  
   CustomGameLogger* logger = (CustomGameLogger*)context;  
   logger->ReportGameRuntimeIssue(hr, msg);  
  
   // Don't ignore the error. For example, continue on and do whatever  
   // is specified by XErrorSetOptions().  
   return true;  
}  
  
void SomeGameFunction()  
{  
   // Previously initialize the game's custom logger  
   // CustomGameLogger* m_logger = InitializeLogger();  
   // ...  
  
   // Setup how you want to handle XErrors  
   XErrorSetOptions(DebugBreakOnError, FailFastOnError);
   XErrorSetCallback(CustomGameXErrorCallback, m_logger);
}  
```

## Configuration requise

**En-tête :** XError.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Threads à durée critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[Membres de XError](/fr/reference/system/xerror/xerror_members)\
[XErrorCallback](/fr/reference/system/xerror/functions/xerrorcallback)


## Related topics

- [XErrorSetCallback](/es/reference/system/xerror/functions/xerrorsetcallback.md)
- [XErrorCallback](/reference/system/xerror/functions/xerrorcallback.md)