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

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

*HResult*\
Type : HRESULT

Le code HRESULT de l'échec.

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

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

*Options*\
Type : [DSTORAGE\_REQUEST\_OPTIONS](/fr-CA/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]

Le nom du fichier ciblé par la requête.

*FileOffset*\
Type : UINT64

Le 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 la mémoire, l'adresse de la mémoire tampon à partir de laquelle lire.

*SourceSize*\
Type : UINT32

Le nombre d'octets à lire à partir de la source.

*CancellationTag*\
Type : UINT64

Un nombre UINT64 arbitraire utilisé pour la correspondance d'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-CA/reference/system/dstorage/interfaces/IDStorageStatusArrayX/idstoragestatusarrayx).

*Index*\
Type : UINT32

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

\**Fence*\
Type : ID3D12Fence

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

*Value*\
Type : UINT64

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

## Remarques

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

Si *CommandType* est `DSTORAGE_COMMAND_TYPE_NONE`, les autres données sont indéfinies.

Pour plus d'informations, consultez la section « GetErrorEvent/RetrieveErrorRecord » de la [vue d'ensemble de DirectStorage](/fr-CA/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-CA/reference/system/dstorage/dstorage_members)


## Related topics

- [DSTORAGE_ERROR_RECORD](/reference/system/dstorage/structs/dstorage_error_record.md)
- [IDStorageQueueX::RetrieveErrorRecord](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_retrieveerrorrecord.md)
- [DSTORAGE_COMMAND_TYPE](/reference/system/dstorage/enums/dstorage_command_type.md)