鸿蒙实战开发（OpenHarmony）Display VDI 接口开发

 鸿蒙NEXT开发实战往期必看文章：

一分钟了解”纯血版！鸿蒙HarmonyOS Next应用开发！

“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线！（从零基础入门到精通）

HarmonyOS NEXT应用开发案例实践总结合（持续更新......）

HarmonyOS NEXT应用开发性能优化实践总结（持续更新......）

概述

显示VDI（Vendor Device Interface）接口是为了方便芯片厂商接入OpenHarmony显示驱动框架模型而提供的接口。 显示VDI接口分为Composer和Buffer部分：

• Composer：负责图层（Layer）合成和显示。
• Buffer：负责申请和释放SurfaceBuffer。

Composer部分

图 1 Display Composer HDI架构

该框架模型内部分为三层，依次为框架层、HDI实现层、和Vendor驱动层。各层基本概念如下：

• 框架层：对接HDI实现层的控制、图层的显示和合成，管理显示模块各个硬件设备等功能。
• HDI实现层：实现OHOS（OpenHarmony Operation System）Composer HDI接口。
• Vendor驱动层：屏蔽底层芯片和OS（Operation System）差异，支持多平台适配。

Buffer部分

图 2 Display Buffer HDI架构

该框架模型内部分为三层，依次为框架层、HDI实现层、和Vendor驱动层。各层基本概念如下：

• 框架层：对接HDI实现层的控制、图形buffer的申请和释放。
• HDI实现层：实现OHOS（OpenHarmony Operation System）Buffer HDI接口。
• Vendor驱动层：屏蔽底层芯片和OS（Operation System）差异，支持多平台适配。

开发指导

Composer部分

接口说明

注：以下接口列举的为VDI接口，接口声明见文件/drivers/peripheral/display/composer/hdi_service/include/idisplay_composer_vdi.h，获取路径为：drivers_peripheral: 暂无描述 - Gitee.com。

• idisplay_composer_vdi.h

  功能描述	接口名称
  注册热插拔事件回调	int32_t RegHotPlugCallback(HotPlugCallback cb, void* data)
  获取显示设备能力集	int32_t GetDisplayCapability(uint32_t devId, DisplayCapability& info)
  获取显示设备支持的显示模式信息	int32_t GetDisplaySupportedModes(uint32_t devId, std::vector<DisplayModeInfo>& modes)
  获取显示设备当前的显示模式	int32_t GetDisplayMode(uint32_t devId, uint32_t& modeId)
  设置显示设备的显示模式	int32_t SetDisplayMode(uint32_t devId, uint32_t modeId)
  获取显示设备当前的电源状态	int32_t GetDisplayPowerStatus(uint32_t devId, DispPowerStatus& status)
  设置显示设备当前的电源状态	int32_t SetDisplayPowerStatus(uint32_t devId, DispPowe