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

# XTaskQueueSetCurrentProcessTaskQueue

> XTaskQueueSetCurrentProcessTaskQueue

# XTaskQueueSetCurrentProcessTaskQueue

Définit la file d'attente de tâches donnée comme file d'attente de tâches à l'échelle du processus.

## Syntaxe

```cpp theme={null}
void XTaskQueueSetCurrentProcessTaskQueue(  
         XTaskQueueHandle queue  
)  
```

### Paramètres

*queue*   \_In\_\
Type : XTaskQueueHandle

File d'attente à configurer comme file d'attente de tâches par défaut pour le processus.

### Valeur de retour

Type : void

## Remarques

<Note>Il n'est pas sûr d'appeler cette fonction sur un thread urgent. Pour plus d'informations, consultez [Threads urgents](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

La file d'attente peut être définie sur nullptr, auquel cas [XTaskQueueGetCurrentProcessTaskQueue](/fr/reference/system/xtaskqueue/functions/xtaskqueuegetcurrentprocesstaskqueue) retournera également nullptr. Le handle de la file d'attente fournie est dupliqué et le handle de toute file d'attente de tâches du processus existante est fermé.

L'exemple suivant remplace la file d'attente de tâches du processus par défaut. Cette file d'attente de tâches utilise le pool de threads pour la distribution du travail et des achèvements. Les API du Microsoft Game Development Kit (GDK) qui prennent des paramètres de file d'attente de tâches acceptent toutes **nullptr** et lui substituent la file d'attente de tâches du processus. La file d'attente de tâches du processus peut également être définie sur **nullptr**, auquel cas les API du Microsoft Game Development Kit (GDK) qui nécessitent un paramètre de file d'attente de tâches échouent avec l'erreur E\_NO\_TASK\_QUEUE si null a été fourni. Cela permet aux API du Microsoft Game Development Kit (GDK) de fonctionner avec des valeurs par défaut tout en permettant un contrôle étroit des handles de file d'attente de tâches si nécessaire.

```cpp theme={null}
void UsingProcessTaskQueue()
{
    XTaskQueueHandle queue = nullptr;
    XTaskQueueGetCurrentProcessTaskQueue(&queue);

    auto callback = [](void*, bool)
    {
        printf("Work callback invoked.\r\n");
    };

    HRESULT hr = XTaskQueueSubmitCallback(
        queue, XTaskQueuePort::Work, 
        nullptr, callback);

    if (FAILED(hr))
    {
        printf("Failed to submit callback: %x\r\n", hr);
        return;
    }

    // You can replace the process task queue.
    hr = XTaskQueueCreate(
        XTaskQueueDispatchMode::Manual, 
        XTaskQueueDispatchMode::Manual, 
        &queue);

    if (FAILED(hr))
    {
        printf("Failed to create new task queue: %x\r\n", hr);
        return;
    }
}
```

## Configuration requise

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

**Bibliothèque :** xgameruntime.lib

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

## Documentation conceptuelle

* [Vue d'ensemble de la bibliothèque XTaskQueue](/fr/build/core-features/common/async/async-libraries/async-library-xtaskqueue)
* [Objectifs de conception et améliorations de la programmation asynchrone](/fr/build/core-features/common/async/async-whitepaper)
* [Threads urgents](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[Membres XTaskQueue](/fr/reference/system/xtaskqueue/xtaskqueue_members)\
[Modèle de programmation asynchrone](/fr/build/core-features/common/async/async-programming-model)\
[Conception de la file d'attente de tâches asynchrones](/fr/build/core-features/common/async/async-task-queue-design)


## Related topics

- [XTaskQueueSetCurrentProcessTaskQueue](/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue.md)
- [XTaskQueueGetCurrentProcessTaskQueue](/reference/system/xtaskqueue/functions/xtaskqueuegetcurrentprocesstaskqueue.md)
- [XTaskQueue](/reference/system/xtaskqueue/xtaskqueue_members.md)
- [How to use XBOX Services APIs (XSAPIs)](/services/xbox-services/fundamentals/xbox-services-api/live-gs-xbl-apis.md)
- [Cómo usar las API de servicios XBOX (XSAPI)](/es/services/xbox-services/fundamentals/xbox-services-api/live-gs-xbl-apis.md)