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

실패한 DirectStorage 요청에 대한 자세한 기록입니다.

## 구문

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

### 멤버

*FailureCount*\
형식: UINT32

마지막 `RetrieveErrorRecord` 호출 이후 큐에서 실패한 요청 수입니다.

*HResult*\
형식: HRESULT

실패의 HRESULT 코드입니다.

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

실패의 원인이 된 enqueue 요청의 유형입니다.

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

실패한 요청의 다양한 옵션입니다.

*Destination*\
형식: void \*

실패한 요청의 최종 결과를 받을 버퍼의 주소입니다.

*DestinationSize*\
형식: UINT32

초기 요청의 일부로 전달된, 실패한 요청의 최종 결과의 예상 크기(바이트)입니다.

*Filename*\
형식: WCHAR\[MAX\_PATH]

요청이 대상으로 한 파일의 이름입니다.

*FileOffset*\
형식: UINT64

파일에서 실패한 읽기 요청의 시작 부분까지의 오프셋(바이트)입니다.

\**Source*\
형식: void

메모리 소스 요청의 경우, 읽어들일 버퍼의 주소입니다.

*SourceSize*\
형식: UINT32

소스에서 읽어들일 바이트 수입니다.

*CancellationTag*\
형식: UINT64

취소 매칭에 사용되는 임의의 UINT64 숫자입니다.

*Name*\
형식: CHAR\[DSTORAGE\_REQUEST\_MAX\_NAME]

요청의 이름입니다.

\**StatusArray*\
형식: IDStorageStatusArrayX

상태 쓰기 요청의 경우, [IDStorageStatusArrayX](/reference/system/dstorage/interfaces/IDStorageStatusArrayX/idstoragestatusarrayx) 개체입니다.

*Index*\
형식: UINT32

상태 쓰기 요청의 경우, 상태를 받을 `IDStorageStatusArrayX` 개체의 상태 항목 인덱스입니다.

\**Fence*\
형식: ID3D12Fence

펜스 쓰기 요청의 경우, `ID3D12Fence` 개체입니다.

*Value*\
형식: UINT64

펜스 쓰기 요청의 경우, 펜스에 쓸 값입니다.

## 설명

이 구조체는 [IDStorageQueueX::RetrieveErrorRecord](/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_retrieveerrorrecord) 메서드에서 사용됩니다.

*CommandType*이 `DSTORAGE_COMMAND_TYPE_NONE`이면 나머지 데이터는 정의되지 않습니다.

자세한 내용은 [DirectStorage 개요](/build/console-features/storage/directstorage/directstorage-overview)의 "GetErrorEvent/RetrieveErrorRecord" 섹션을 참조하세요.

## 요구 사항

**헤더:** dstorage\_xs.h

**지원되는 플랫폼:** XBOX Series 콘솔

## 함께 보기

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


## Related topics

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