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

### Valeur de retour

Type : void

## Remarques

<Note>Cette fonction ne peut pas être appelée en toute sécurité sur un thread sensible au temps. Pour plus d'informations, consultez [Threads sensibles au temps](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-CA/reference/system/xtaskqueue/functions/xtaskqueuegetcurrentprocesstaskqueue) retournera également nullptr. Le handle de la file d'attente fournie sera dupliqué, et le handle de toute file d'attente de tâches de processus existante sera fermé.

L'exemple suivant remplace la file d'attente de tâches de 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 acceptent des paramètres de file d'attente de tâches acceptent toutes **nullptr** et y 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 exigent un paramètre de file d'attente de tâches échoueront avec E\_NO\_TASK\_QUEUE si une valeur nulle est fournie. 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 au besoin.

```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-CA/build/core-features/common/async/async-libraries/async-library-xtaskqueue)
* [Objectifs de conception et améliorations de la programmation asynchrone](/fr-CA/build/core-features/common/async/async-whitepaper)
* [Threads sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[Membres de XTaskQueue](/fr-CA/reference/system/xtaskqueue/xtaskqueue_members)\
[Modèle de programmation asynchrone](/fr-CA/build/core-features/common/async/async-programming-model)\
[Conception de la file d'attente de tâches asynchrones](/fr-CA/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)