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

# SetHDRToneMapperX (XBOX One 系列)

> 設定高動態範圍 (HDR) 色調對應器，用於在 HDR 遊戲啟用自動色調對應時，於執行階段產生標準動態範圍 (SDR) 影像。

設定高動態範圍 (HDR) 色調對應器，用於在 HDR 遊戲針對 XBOX One 啟用自動色調對應時，於執行階段產生標準動態範圍 (SDR) 影像。

## 語法

```cpp theme={null}
HRESULT SetHDRToneMapperX(  
         ID3D12Resource* pHDRToneMapper  
)  
```

### 參數

*pHDRToneMapper*   \_In\_opt\_\
類型：ID3D12Resource\*

指向 3D 紋理的指標，該紋理會將遊戲的 HDR 色調對應器編碼為 3D 查閱表 (LUT)。傳遞 nullptr 可在自動色調對應期間使用預設色調對應器。

### 傳回值

類型：HRESULT

HRESULT 傳回值。

## 備註

SDR 影像會用於 GameDVR、串流和廣播，但不會用於螢幕擷取畫面。螢幕擷取畫面一律由系統自動產生。此 API 僅適用於 XBOX One 上的自動色調對應，不會影響 XBOX Series X|S 主機的自動色調對應。請參閱[高動態範圍 (HDR) 輸出](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/graphics/overviews/hdr-support)中的自動色調對應一節。

紋理的大小必須為 32x32x32，格式必須為 [DXGI\_FORMAT\_R10G10B10A2\_UNORM](https://learn.microsoft.com/en-us/windows/win32/api/dxgiformat/ne-dxgiformat-dxgi_format)。LUT 中的值應編碼為線性且未經過 Gamma 校正的 SDR 色彩。請參閱 HDRAutoToneMapping 範例。

## 需求

**標頭：** d3d12\_x.h

**程式庫：** d3d12\_x.lib

**支援的平台：** XBOX One 系列

## 另請參閱

[ID3D12CommandQueue](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/id3d12commandqueue)\
[GameDVR 與廣播](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/system/overviews/gamedvr-broadcast)


## Related topics

- [IGameInputMapper](/reference/input/gameinput/interfaces/igameinputmapper/igameinputmapper.md)
- [CreateInputMapper](/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_createinputmapper.md)
- [IGameInputMapper::GetGamepadButtonMapping](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadbuttonmappinginfo.md)
- [IGameInputMapper::GetGamepadAxisMappingInfo](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadaxismappinginfo.md)
- [IGameInputMapper::GetRacingWheelButtonMappingInfo](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getracingwheelbuttonmappinginfo.md)