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

> 資源中壓縮資料流的相關資訊。

資源中壓縮資料流的相關資訊。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
typedef struct XBTC_STREAM_INFO {  
    uint32_t RelativeOffset;  
    uint32_t CompressedSize;  
    uint32_t InflatedSize;  
    uint32_t UncompressedSize;  
} XBTC_STREAM_INFO  
```

<a id="membersSection" />

### 成員

*RelativeOffset*\
類型: uint32\_t

到資料流起始處的相對位移。

*CompressedSize*\
類型: uint32\_t

資料流壓縮後，壓縮資料流的長度 (以位元組為單位)。

*InflatedSize*\
類型: uint32\_t

資料流經 Deflate 演算法膨脹後的長度 (以位元組為單位)。

*UncompressedSize*\
類型: uint32\_t

未壓縮資料流分別經 BCPack 與 Deflate 演算法解壓縮及膨脹後的長度 (以位元組為單位)。

<a id="remarksSection" />

## 備註

請使用 [XBTCArchiveReader](/zh-TW/reference/graphics/xbtc/interfaces/XBTCArchiveReader/xbtcarchivereader) 執行個體的 [GetStreamInfo](/zh-TW/reference/graphics/xbtc/interfaces/XBTCArchiveReader/methods/xbtcarchivereader_getstreaminfo) 方法，存取封存中指定紋理的此結構。

請使用此結構來找出紋理中到資料流起始處的相對位移，以及該資料流預期的壓縮、膨脹及未壓縮大小。資料流之此結構中的 `RelativeOffset` 值，是相對於該資料流所屬紋理之 [XBTC\_OFFSET\_AND\_INDEX](/zh-TW/reference/graphics/xbtc/structs/xbtc_offset_and_index) 結構的 `BaseOffset` 值。

`CompressedSize`、`InflatedSize` 和 `UncompressedSize` 的值會依套用至資料流的壓縮演算法 (若有) 而有所不同。您可以比較這三個值，判斷資料流是否以 BCPack 或 Deflate 演算法壓縮。下表說明這些值如何因壓縮演算法而異:

| 演算法 | 結果 |
| - | - |
| 無 | 資料流未經壓縮。<br />`CompressedSize`、`InflatedSize` 和 `UncompressedSize` 會設定為未壓縮資料流的大小 (以位元組為單位)。 |
| 僅 BCPack | 資料流以 BCPack 演算法壓縮。<br />`CompressedSize` 和 `InflatedSize` 會設定為壓縮資料流的大小 (以位元組為單位)。`UncompressedSize` 會設定為未壓縮資料流的大小。 |
| 僅 Deflate | 資料流以 Deflate 演算法壓縮。<br />`CompressedSize` 會設定為壓縮資料流的大小 (以位元組為單位)。`InflatedSize` 和 `UncompressedSize` 會設定為未壓縮資料流的大小。 |
| BCPack 和 Deflate | 資料流先以 BCPack 演算法壓縮，再以 Deflate 演算法壓縮其結果。<br />`CompressedSize` 會設定為同時使用 BCPack 和 Deflate 演算法後壓縮資料流的大小 (以位元組為單位)。`InflatedSize` 會設定為僅使用 BCPack 演算法後資料流的大小。`UncompressedSize` 會設定為未壓縮資料流的大小。 |

如需 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\_ARCHIVE\_HEADER](/zh-TW/reference/graphics/xbtc/structs/xbtc_archive_header)\
[XBTC\_OFFSET\_AND\_INDEX](/zh-TW/reference/graphics/xbtc/structs/xbtc_offset_and_index)\
[XBTC\_TEXTURE\_INFO](/zh-TW/reference/graphics/xbtc/structs/xbtc_texture_info)\
[XBTC](/zh-TW/reference/graphics/xbtc/xbtc_members)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [XBOX Texture Compressor (XBTC) 工具參考](/zh-TW/build/core-features/graphics/newfeatures/xbtc/index.md)
- [使用 XDXR 在 XBOX Series X|S 上進行光線追蹤](/zh-TW/build/core-features/graphics/newfeatures/raytracing/index.md)
- [XBOX Series X|S 上的 Mesh Shader 與 Meshlet](/zh-TW/build/core-features/graphics/newfeatures/ms/index.md)
- [XBOX Series X|S 上的取樣器意見反應與 SFS](/zh-TW/build/core-features/graphics/newfeatures/sfs/index.md)