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

# XFrontPanelGetScreenPixelFormat

> XFrontPanelGetScreenPixelFormat

# XFrontPanelGetScreenPixelFormat

获取正面板显示屏的像素格式。

<a id="syntaxSection" />

## 语法

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

<a id="parametersSection" />

### 参数

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

指向一个值的指针，该值指示像素格式。

<a id="retvalSection" />

### 返回值

类型：HRESULT

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

<a id="remarksSection" />

## 注解

此方法返回的像素格式为 `DXGI_FORMAT_R8_UNORM`。显示屏仅支持每像素 4 位；低 4 位未使用。

使用像素格式为 [XFrontPanelPresentBuffer](/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelpresentbuffer) 函数构造缓冲区。

有关详细信息，请参阅 [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)。

<a id="requirementsSection" />

## 要求

**头文件：** xfrontpaneldisplay.h

**库：** xfrontpaneldisplay.lib

**支持的平台：** XBOX One 系列主机和 XBOX Series 主机

<a id="seealsoSection" />

## 另请参阅

[XFrontPanelDisplay](/reference/devkit/xfrontpaneldisplay/xfrontpaneldisplay_members)


## Related topics

- [XFrontPanelPresentBuffer](/zh-CN/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelpresentbuffer.md)
- [XFrontPanelDisplay](/zh-CN/reference/devkit/xfrontpaneldisplay/xfrontpaneldisplay_members.md)
- [XFrontPanelGetScreenDimensions](/zh-CN/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelgetscreendimensions.md)
- [XFrontPanelIsSupported](/zh-CN/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelissupported.md)
- [Front Panel URIs](/zh-CN/reference/deviceportal/frontpanel/atoc-rest-frontpanel.md)