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

# XMemGetAllocationStatistics

> XMemGetAllocationStatistics récupère le nombre d'allocations et le total d'octets d'un tas de titre XBOX GDK spécifié au moyen de la structure XMEM_HEAP_STATISTICS.

# XMemGetAllocationStatistics

Obtient les statistiques d'un tas donné.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
BOOL XMemGetAllocationStatistics(  
         DWORD MemType,  
         BOOL LargeHeap,  
         PXMEM_HEAP_STATISTICS Statistics  
)  
```

<a id="parametersSection" />

### Paramètres

*MemType*   \_In\_<br />Type : DWORD

La constante `XALLOC_MEMTYPE_GRAPHICS_*` décrivant le tas. Pour plus d'informations, consultez la section [MemoryType](/fr-CA/reference/system/xmem/structs/xalloc_attributes#memorytypeSection) dans [XALLOC\_ATTRIBUTES](/fr-CA/reference/system/xmem/structs/xalloc_attributes).

*LargeHeap*   \_In\_<br />Type : BOOL

`TRUE` si le tas est « grand »; sinon, `FALSE`. Un « grand » tas est utilisé pour satisfaire les allocations de 4 Ko à 128 Ko, ou dont l'alignement est spécifié à 4 Ko ou plus. En comparaison, un « petit » tas est utilisé pour satisfaire les allocations inférieures à 4 Ko et dont l'alignement est spécifié à moins de 4 Ko.

*Statistics*   \_Inout\_<br />Type : PXMEM\_HEAP\_STATISTICS

Un pointeur vers la structure [XMEM\_HEAP\_STATISTICS](/fr-CA/reference/system/xmem/structs/xmem_heap_statistics) qui contiendra les statistiques.

<a id="retvalSection" />

### Valeur de retour

Type : BOOL

Retourne `TRUE` si la structure [XMEM\_HEAP\_STATISTICS](/fr-CA/reference/system/xmem/structs/xmem_heap_statistics) a pu être remplie; sinon, `FALSE`.

<a id="remarksSection" />

## Remarques

Cette fonction retourne des statistiques, telles que la taille allouée maximale et le nombre d'allocations, dans une structure `XMEM_HEAP_STATISTICS` pour le tas décrit dans `MemType`. Pour plus d'informations sur la mémoire graphique, consultez [Vue d'ensemble de la mémoire graphique pour le GDK](/fr-CA/build/core-features/graphics/graphics-memory-overview).

L'exemple suivant illustre comment utiliser cette fonction pour obtenir des statistiques sur la mémoire « garlic » (à écriture combinée pour le CPU et non cohérente pour le GPU).

```cpp theme={null}
XMEM_HEAP_STATISTICS statistics;
statistics.dwSize = sizeof( statistics );
BOOL success = XMemGetAllocationStatistics(XALLOC_MEMTYPE_GRAPHICS_WRITECOMBINE, TRUE, &statistics);  
```

<a id="requirementsSection" />

## Configuration requise

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

**Bibliothèque :** xmem.lib

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

<a id="seealsoSection" />

## Voir aussi

[Diagnostics et suivi de la mémoire](/fr-CA/build/console-features/memory/system-memory-diagnostics)<br />[XALLOC\_ATTRIBUTES](/fr-CA/reference/system/xmem/structs/xalloc_attributes)<br />[XMEM\_HEAP\_STATISTICS](/fr-CA/reference/system/xmem/structs/xmem_heap_statistics)<br />[XMem](/fr-CA/reference/system/xmem/xmem_members)


## Related topics

- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [XMemGetWin32HeapStatistics](/reference/system/xmem/functions/xmemgetwin32heapstatistics.md)
- [XMemGetWorkingSetStatistics](/reference/system/xmem/functions/xmemgetworkingsetstatistics.md)
- [WIN32_HEAP_STATISTICS](/reference/system/xmem/structs/win32_heap_statistics.md)
- [PFMemGetFunctions](/services/playfab/api-references/c/pfplatform/functions/pfmemgetfunctions.md)