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

# XBTC_ARCHIVE_HEADER

> XBTC 封存的 16 位元組標頭。

XBTC 封存的 16 位元組標頭。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
typedef struct XBTC_ARCHIVE_HEADER {  
    uint32_t Identifier;  
    uint32_t Version : 8;  
    uint32_t TextureCount : 24;  
    uint64_t DataOffset : 24;  
    uint64_t DataSize : 40;  
} XBTC_ARCHIVE_HEADER  
```

<a id="membersSection" />

### 成員

*Identifier*\
類型: uint32\_t

封存的 FOURCC 檔案識別碼，為串連四個 ASCII 字元所建立的 32 位元不帶正負號整數。此值設定為 "XBTC" 的串連。

*Version*\
類型: uint32\_t

封存的格式版本。

*TextureCount*\
類型: uint32\_t

封存中個別紋理描述的數目。

*DataOffset*\
類型: uint64\_t

封存中資料的起始位移位置 (以位元組為單位)。此值設定為標頭與索引的大小 (以位元組為單位)。

*DataSize*\
類型: uint64\_t

封存中所儲存資料的大小 (以位元組為單位)。

<a id="remarksSection" />

## 備註

[XBTCArchiveReader](/zh-TW/reference/graphics/xbtc/interfaces/XBTCArchiveReader/xbtcarchivereader) 執行個體會使用此結構來識別、開啟及剖析 XBTC 封存。請使用 [OpenFromFile](/zh-TW/reference/graphics/xbtc/interfaces/XBTCArchiveReader/methods/xbtcarchivereader_openfromfile) 方法來開啟及剖析儲存為檔案的封存。您也可以呼叫 [OpenFromMemory](/zh-TW/reference/graphics/xbtc/interfaces/XBTCArchiveReader/methods/xbtcarchivereader_openfrommemory) 方法並指定指向該封存之 `XBTC_ARCHIVE_HEADER` 結構的指標，以開啟及剖析儲存在記憶體中的封存。

此結構一律代表 XBTC 封存的前 16 個位元組，且 `DataOffset` 與 `DataSize` 中的值總和應等於封存的總大小 (以位元組為單位)。如需 XBTC 封存內容與結構的詳細資訊，請參閱 [XBOX Texture Compressor (XBTC) 封存檔案規格](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/graphics/newfeatures/xbtc/xbtc-archive-format)。

<a id="requirementsSection" />

## 需求

**標頭:** XBTC.h

**支援的平台**: XBOX One 系列主機與 XBOX Series 主機

<a id="seealsoSection" />

## 另請參閱

[XBTC\_OFFSET\_AND\_INDEX](/zh-TW/reference/graphics/xbtc/structs/xbtc_offset_and_index)\
[XBTC\_STREAM\_INFO](/zh-TW/reference/graphics/xbtc/structs/xbtc_stream_info)\
[XBTC\_TEXTURE\_INFO](/zh-TW/reference/graphics/xbtc/structs/xbtc_texture_info)\
[XBTC](/zh-TW/reference/graphics/xbtc/xbtc_members)


## Related topics

- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [NDA 主题目录 - Microsoft Learn 在线链接](/zh-CN/nda/nda-topic-directory.md)
- [NDA トピック ディレクトリ - Microsoft Learn 公開版へのリンク](/ja-jp/nda/nda-topic-directory.md)
- [XBOX Texture Compressor (XBTC) tool reference](/build/core-features/graphics/newfeatures/xbtc/index.md)