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

# SetAllocatorCallbackX (famille XBOX One)

> Définit une fonction de rappel d'allocation pour l'allocateur de commandes.

Définit une fonction de rappel d'allocation pour l'allocateur de commandes.

## Syntaxe

```cpp theme={null}
void SetAllocatorCallbackX(  
         D3D12XBOX_COMMAND_ALLOCATOR_CALLBACK pCallback,  
         UINT64 Context  
)  
```

### Paramètres

*pCallback*   \_In\_\
Type : D3D12XBOX\_COMMAND\_ALLOCATOR\_CALLBACK

Pointeur vers une définition **D3D12XBOX\_COMMAND\_ALLOCATOR\_CALLBACK**. Notez que D3D12XBOX\_COMMAND\_ALLOCATOR\_CALLBACK est défini comme suit :

```cpp theme={null}
typedef void* (*D3D12XBOX_COMMAND_ALLOCATOR_CALLBACK)(
        ID3D12CommandAllocator* pCommandAllocator,
        ID3D12CommandList* pCommandList,
        UINT XMemAllocType,
        SIZE_T SizeInBytes,
        UINT AlignmentInBytes,
        UINT Flags,
        UINT64 Context); 
```

*Context*   \_In\_\
Type : UINT64

Valeur définie par l'utilisateur qui est passée au rappel.

### Valeur de retour

Type : void

## Remarques

Vous pouvez créer une fonction de rappel définie par l'utilisateur pour un allocateur de commandes, qui gère toutes les allocations de mémoire exécutées par l'allocateur. Lorsqu'un rappel est défini, il incombe à ce rappel de satisfaire les demandes d'allocation de mémoire en fonction de la taille, de l'alignement et du type de mémoire [XALLOC\_ATTRIBUTES](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/reference/system/xmem/structs/xalloc_attributes) donnés, et de retourner les allocations au runtime. Le rappel doit effectuer le suivi de ces allocations et les libérer explicitement lorsqu'elles ne sont plus utilisées.

Pour plus d'informations sur les listes de commandes et les allocateurs de commandes, consultez [Création et enregistrement de listes de commandes et de bundles](https://learn.microsoft.com/en-us/windows/win32/direct3d12/recording-command-lists-and-bundles#creating-command-lists).

<Note>
  Vous ne devez pas libérer la mémoire avant un appel à [Reset](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/nf-d3d12-id3d12commandallocator-reset) sur l'allocateur de commandes.
</Note>

## Configuration requise

**En-tête :** d3d12\_x.h

**Bibliothèque :** d3d12\_x.lib

**Plateformes prises en charge :** famille XBOX One

## Voir aussi

[ID3D12CommandAllocator](/fr-CA/reference/graphics/d3d12_x/interfaces/ID3D12CommandAllocator/id3d12commandallocator)\
[CreateCommandAllocator](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12device-createcommandallocator)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [XMemSetAllocationHooks](/reference/system/xmem/functions/xmemsetallocationhooks.md)
- [XALLOC_ALLOCATOR_IDS](/reference/system/xmem/enums/xalloc_allocator_ids.md)
- [CreateCommandAllocator](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcommandallocator_public.md)