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

# XFrontPanelPresentBuffer

> XFrontPanelPresentBuffer

# XFrontPanelPresentBuffer

将指定的缓冲区渲染到正面板显示屏。

## 语法

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

### 参数

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

缓冲区大小（以字节为单位）。

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

指向要渲染到屏幕的像素数组的指针。

### 返回值

类型：HRESULT

如果成功则返回 `S_OK`；否则返回错误代码。

## 注解

一般情况下，仅在需要更新正面板显示屏时才调用此函数。只有在需要动画时才需要为每一帧都调用此函数。

若要获取用于 *buffer* 的像素格式，请使用 [XFrontPanelGetScreenPixelFormat](https://docs.xbox.com/zh-CN/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelgetscreenpixelformat.md)。

若要获取正面板显示屏的尺寸，请使用 [XFrontPanelGetScreenDimensions](https://docs.xbox.com/zh-CN/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelgetscreendimensions.md)。

有关详细信息，请参阅 [XBOX One X: Using the front panel display (NDA topic)](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-CN/reference/devkit/xfrontpaneldisplay/xfrontpaneldisplay_members.md)


## Related topics

- [XFrontPanelIsSupported](https://docs.xbox.com/zh-CN/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelissupported.md)
- [XFrontPanelGetScreenPixelFormat](https://docs.xbox.com/zh-CN/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelgetscreenpixelformat.md)
- [XFrontPanelDisplay（API 内容）](https://docs.xbox.com/zh-CN/reference/devkit/xfrontpaneldisplay/xfrontpaneldisplay_members.md)
- [XFrontPanelButton](https://docs.xbox.com/zh-CN/reference/devkit/xfrontpaneldisplay/enums/xfrontpanelbutton.md)
- [XFrontPanelLight](https://docs.xbox.com/zh-CN/reference/devkit/xfrontpaneldisplay/enums/xfrontpanellight.md)