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

# Méthode ILampArray::GetIndicesForPurposes

> Remplit une mémoire tampon fournie par l'appelant avec les index des Lamps correspondant aux LampPurposes donnés; dimensionnez d'abord la mémoire tampon avec GetIndicesCountForPurposes.

# ILampArray::GetIndicesForPurposes

Remplit une mémoire tampon d'index de Lamps qui prennent en charge un ensemble de LampPurposes donné. Avant d'appeler cette méthode, la taille maximale de la mémoire tampon doit être obtenue en appelant [ILampArray::GetIndicesCountForPurposes](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicescountforpurposes).

## Syntaxe

```cpp theme={null}
void GetIndicesForPurposes(
    LampPurposes lampPurposes,
    uint32_t lampIndicesCount,
    uint32_t * lampIndices)
```

### Paramètres

*lampPurposes*
Type : [LampPurposes](/fr-CA/reference/lighting/lamparray/enums/lamppurposes)

L'ensemble de LampPurposes souhaité.

*lampIndicesCount*\
Type : uint32\_t

La taille de la mémoire tampon à remplir.

*lampIndices*  \_Out\_writes\_(lampIndicesCount)
Type : uint32\_t\*

La mémoire tampon des index de Lamps. Les index écrits dans la mémoire tampon correspondent aux Lamps qui répondent à tous les indicateurs de lampPurposes.

### Valeur de retour

Type : void

## Remarques

Le code suivant montre comment définir une couleur pour toutes les Lamps d'image de marque d'un ILampArray :

```cpp theme={null}
void UpdateBrandingLamps(ILampArray* lampArray)
{
    // Get the number of Branding lamps
    LampPurposes purposes = LampPurposes::Branding;
    uint32_t indicesCount = lampArray->GetIndicesCountForPurposes(purposes);

    // Allocate and populate a buffer with the indices of those Lamps
    std::vector<uint32_t> indicesBuffer(indicesCount);
    lampArray->GetIndicesForPurposes(purposes, indicesCount, indicesBuffer.data());

    // Set color for all Branding Lamps to red.
    std::vector<LampArrayColor> colorsBuffer(indicesCount);
    for (uint32_t i = 0; i < indicesCount; i++)
    {
        colorsBuffer[i] = { 0xFF /* r */, 0x0 /* g */, 0x0 /* b */, 0xFF /* a */ };
    }

    lampArray->SetColorsForIndices(indicesCount, indicesBuffer.data(), colorsBuffer.data());
}
```

## Configuration requise

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

**Bibliothèque :** xgameplatform.lib

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

## Voir aussi

[Vue d'ensemble de l'API d'éclairage](/fr-CA/build/core-features/common/lighting/gc-lighting-toc)\
[ILampArray::GetIndicesCountForPurposes](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicescountforpurposes)\
[ILampArray::SetColorsForIndices](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices)\
[ILampArray](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/ilamparray)


## Related topics

- [Méthode ILampArray::GetIndicesCountForPurposes](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getindicescountforpurposes.md)
- [Méthode ILampArray::SetColorsForIndices](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices.md)
- [Méthode ILampArray::GetLampArrayKind](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlamparraykind.md)
- [Méthode ILampArray::GetLampCount](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlampcount.md)
- [Méthode ILampArray::GetLampInfo](/fr-CA/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlampinfo.md)