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

# DSTORAGE_ERROR_RECORD

> DSTORAGE_ERROR_RECORD

# DSTORAGE\_ERROR\_RECORD

Enregistrement détaillé d'une requête DirectStorage ayant échoué.

## Syntaxe

```cpp theme={null}
typedef struct DSTORAGE_ERROR_RECORD {  
    UINT32 FailureCount;  
    struct   
    {  
        HRESULT HResult ;  
        DSTORAGE_COMMAND_TYPE CommandType;  
        union  
        {  
            struct   
            {  
                DSTORAGE_REQUEST_OPTIONS Options;  
                void *Destination;  
                UINT32 DestinationSize;  
                WCHAR Filename[MAX_PATH];  
                UINT64 FileOffset;  
                void *Source;  
                UINT32 SourceSize;  
                UINT64 CancellationTag;  
                CHAR Name[DSTORAGE_REQUEST_MAX_NAME];  
            } Request;  
            struct   
            {  
                IDStorageStatusArrayX *StatusArray;  
                UINT32 Index;  
            } Status;  
            struct   
            {  
                ID3D12Fence *Fence;  
                UINT64 Value;  
            } Signal;  
        };  
    } FirstFailure;  
} DSTORAGE_ERROR_RECORD  
```

### Membres

*FailureCount*\
Type : UINT32

Nombre de requêtes ayant échoué dans la file d'attente depuis le dernier appel à `RetrieveErrorRecord`.

*HResult*\
Type : HRESULT

Code HRESULT de l'échec.

*CommandType*\
Type : [DSTORAGE\_COMMAND\_TYPE](/fr/reference/system/dstorage/enums/dstorage_command_type)

Type de la requête mise en file d'attente qui a provoqué l'échec.

*Options*\
Type : [DSTORAGE\_REQUEST\_OPTIONS](/fr/reference/system/dstorage/structs/dstorage_request_options)

Diverses options de la requête ayant échoué.

*Destination*\
Type : void \*

Adresse de la mémoire tampon devant recevoir le résultat final de la requête ayant échoué.

*DestinationSize*\
Type : UINT32

Taille attendue, en octets, du résultat final de la requête ayant échoué, telle que transmise dans la requête initiale.

*Filename*\
Type : WCHAR\[MAX\_PATH]

Nom du fichier ciblé par la requête.

*FileOffset*\
Type : UINT64

Décalage, en octets, dans le fichier jusqu'au début de la requête de lecture ayant échoué.

\**Source*\
Type : void

Pour une requête dont la source est en mémoire, adresse de la mémoire tampon à partir de laquelle lire.

*SourceSize*\
Type : UINT32

Nombre d'octets à lire à partir de la source.

*CancellationTag*\
Type : UINT64

Nombre UINT64 arbitraire utilisé pour la correspondance lors de l'annulation.

*Name*\
Type : CHAR\[DSTORAGE\_REQUEST\_MAX\_NAME]

Nom de la requête.

\**StatusArray*\
Type : IDStorageStatusArrayX

Pour une requête d'écriture d'état, l'objet [IDStorageStatusArrayX](/fr/reference/system/dstorage/interfaces/IDStorageStatusArrayX/idstoragestatusarrayx).

*Index*\
Type : UINT32

Pour une requête d'écriture d'état, index de l'entrée d'état de l'objet `IDStorageStatusArrayX` qui doit recevoir l'état.

\**Fence*\
Type : ID3D12Fence

Pour une requête d'écriture de fence, l'objet `ID3D12Fence`.

*Value*\
Type : UINT64

Pour une requête d'écriture de fence, valeur à écrire dans la fence.

## Remarques

Cette structure est utilisée par la méthode [IDStorageQueueX::RetrieveErrorRecord](/fr/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_retrieveerrorrecord).

Si *CommandType* a la valeur `DSTORAGE_COMMAND_TYPE_NONE`, les données restantes sont indéfinies.

Pour plus d'informations, consultez la section « GetErrorEvent/RetrieveErrorRecord » de [Vue d'ensemble de DirectStorage](/fr/build/console-features/storage/directstorage/directstorage-overview).

## Configuration requise

**En-tête :** dstorage\_xs.h

**Plateformes prises en charge :** consoles XBOX Series

## Voir aussi

[DStorage](/fr/reference/system/dstorage/dstorage_members)


## Related topics

- [IDStorageQueueX::RetrieveErrorRecord](/fr/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_retrieveerrorrecord.md)
- [DSTORAGE_COMMAND_TYPE](/fr/reference/system/dstorage/enums/dstorage_command_type.md)
- [DSTORAGE_REQUEST_OPTIONS](/fr/reference/system/dstorage/structs/dstorage_request_options.md)
- [DStorage](/fr/reference/system/dstorage/dstorage_members.md)
- [IDStorageQueueX::CancelRequestsWithTag](/fr/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_cancelrequestswithtag.md)