> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XFrontPanelGetScreenPixelFormat

> XFrontPanelGetScreenPixelFormat

# XFrontPanelGetScreenPixelFormat

取得前面板顯示器的像素格式。

## 語法

```cpp theme={null}
HRESULT XFrontPanelGetScreenPixelFormat(  
         DXGI_FORMAT* pixelFormat  
)  
```

### 參數

*pixelFormat*   \_Out\_\
類型：DXGI\_FORMAT\*

值的指標，指出像素格式。

### 傳回值

類型：HRESULT

如果成功，會傳回 `S_OK`；否則會傳回錯誤碼。

## 備註

此方法傳回的像素格式為 `DXGI_FORMAT_R8_UNORM`。顯示器僅支援每像素 4 位元；較低的四個位元不會使用。

請使用此像素格式來建構 [XFrontPanelPresentBuffer](https://docs.xbox.com/zh-TW/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelpresentbuffer.md) 函式的緩衝區。

如需詳細資訊，請參閱 [XBOX One X：使用前面板顯示器 (NDA 主題)](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/dev-kits/concepts/scorpio-frontpanel)。

## 需求

**標頭：** xfrontpaneldisplay.h

**程式庫：** xfrontpaneldisplay.lib

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XFrontPanelDisplay](https://docs.xbox.com/zh-TW/reference/devkit/xfrontpaneldisplay/xfrontpaneldisplay_members.md)


## Related topics

- [XFrontPanelPresentBuffer](https://docs.xbox.com/zh-TW/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelpresentbuffer.md)
- [XFrontPanelDisplay (API 內容)](https://docs.xbox.com/zh-TW/reference/devkit/xfrontpaneldisplay/xfrontpaneldisplay_members.md)
- [XFrontPanelGetScreenDimensions](https://docs.xbox.com/zh-TW/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelgetscreendimensions.md)
- [XFrontPanelIsSupported](https://docs.xbox.com/zh-TW/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelissupported.md)
- [XFrontPanelLight](https://docs.xbox.com/zh-TW/reference/devkit/xfrontpaneldisplay/enums/xfrontpanellight.md)