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

Registro detalhado de uma solicitação do DirectStorage com falha.

## Sintaxe

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

### Membros

*FailureCount*\
Tipo: UINT32

O número de solicitações com falha na fila desde a última chamada de `RetrieveErrorRecord`.

*HResult*\
Tipo: HRESULT

O código HRESULT da falha.

*CommandType*\
Tipo: [DSTORAGE\_COMMAND\_TYPE](/pt-BR/reference/system/dstorage/enums/dstorage_command_type)

Tipo da solicitação de enfileiramento que causou a falha.

*Options*\
Tipo: [DSTORAGE\_REQUEST\_OPTIONS](/pt-BR/reference/system/dstorage/structs/dstorage_request_options)

Várias opções da solicitação com falha.

*Destination*\
Tipo: void \*

Endereço do buffer que receberá o resultado final da solicitação com falha.

*DestinationSize*\
Tipo: UINT32

Tamanho esperado, em bytes, do resultado final da solicitação com falha, conforme passado como parte da solicitação inicial.

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

O nome do arquivo de destino da solicitação.

*FileOffset*\
Tipo: UINT64

O deslocamento, em bytes, no arquivo até o início da solicitação de leitura com falha.

\**Source*\
Tipo: void

Para uma solicitação com origem na memória, o endereço do buffer do qual ler.

*SourceSize*\
Tipo: UINT32

O número de bytes a serem lidos da origem.

*CancellationTag*\
Tipo: UINT64

Um número UINT64 arbitrário usado para correspondência de cancelamento.

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

Nome da solicitação.

\**StatusArray*\
Tipo: IDStorageStatusArrayX

Para uma solicitação de gravação de status, o objeto [IDStorageStatusArrayX](/pt-BR/reference/system/dstorage/interfaces/IDStorageStatusArrayX/idstoragestatusarrayx).

*Index*\
Tipo: UINT32

Para uma solicitação de gravação de status, o índice da entrada de status no objeto `IDStorageStatusArrayX` que receberá o status.

\**Fence*\
Tipo: ID3D12Fence

Para uma solicitação de gravação de fence, o objeto `ID3D12Fence`.

*Value*\
Tipo: UINT64

Para uma solicitação de gravação de fence, o valor a ser gravado no fence.

## Comentários

Esta estrutura é usada pelo método [IDStorageQueueX::RetrieveErrorRecord](/pt-BR/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_retrieveerrorrecord).

Se *CommandType* for `DSTORAGE_COMMAND_TYPE_NONE`, os dados restantes serão indefinidos.

Para obter mais informações, consulte a seção "GetErrorEvent/RetrieveErrorRecord" em [Visão geral do DirectStorage](/pt-BR/build/console-features/storage/directstorage/directstorage-overview).

## Requisitos

**Cabeçalho:** dstorage\_xs.h

**Plataformas compatíveis:** consoles XBOX Series

## Confira também

[DStorage](/pt-BR/reference/system/dstorage/dstorage_members)


## Related topics

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