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

# XFrontPanelPresentBuffer

> XFrontPanelPresentBuffer

# XFrontPanelPresentBuffer

將指定的緩衝區轉譯至前面板顯示器。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
HRESULT XFrontPanelPresentBuffer(  
         uint32_t bufferSize,  
         const uint8_t* buffer  
)  
```

<a id="parametersSection" />

### 參數

*bufferSize*   \_In\_\
類型：uint32\_t

緩衝區的大小 (以位元組為單位)。

*buffer*   \_In\_reads\_(bufferSize)\
類型：uint8\_t\*

要轉譯至螢幕之像素陣列的指標。

<a id="retvalSection" />

### 傳回值

類型：HRESULT

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

<a id="remarksSection" />

## 備註

一般而言，只有在需要更新前面板顯示器時才呼叫此函式。只有動畫才需要在每個畫面格都呼叫它。

若要取得 *buffer* 中要使用的像素格式，請使用 [XFrontPanelGetScreenPixelFormat](/zh-TW/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelgetscreenpixelformat)。

若要取得前面板顯示器的尺寸，請使用 [XFrontPanelGetScreenDimensions](/zh-TW/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelgetscreendimensions)。

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

<a id="requirementsSection" />

## 需求

**標頭：** xfrontpaneldisplay.h

**程式庫：** xfrontpaneldisplay.lib

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

<a id="seealsoSection" />

## 另請參閱

[XFrontPanelDisplay](/zh-TW/reference/devkit/xfrontpaneldisplay/xfrontpaneldisplay_members)


## Related topics

- [XFrontPanelIsSupported](/zh-TW/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelissupported.md)
- [XFrontPanelDisplay](/zh-TW/reference/devkit/xfrontpaneldisplay/xfrontpaneldisplay_members.md)
- [XFrontPanelGetScreenPixelFormat](/zh-TW/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelgetscreenpixelformat.md)
- [XFrontPanelButton](/zh-TW/reference/devkit/xfrontpaneldisplay/enums/xfrontpanelbutton.md)
- [XFrontPanelLight](/zh-TW/reference/devkit/xfrontpaneldisplay/enums/xfrontpanellight.md)