1# native_audio_device_base.h 2<!--Kit: Audio Kit--> 3<!--Subsystem: Multimedia--> 4<!--Owner: @songshenke--> 5<!--Designer: @caixuejiang; @hao-liangfei; @zhanganxiang--> 6<!--Tester: @Filger--> 7<!--Adviser: @zengyawen--> 8 9## 概述 10 11定义音频设备参数的类型以及获取每个设备参数的接口。 12 13**库：** libohaudio.so 14 15**引用文件：** <ohaudio/native_audio_device_base.h> 16 17**系统能力：** SystemCapability.Multimedia.Audio.Core 18 19**起始版本：** 12 20 21**相关模块：** [OHAudio](capi-ohaudio.md) 22 23## 汇总 24 25### 结构体 26 27| 名称 | typedef关键字 | 描述 | 28| -- | -- | -- | 29| [OH_AudioDeviceDescriptorArray](capi-ohaudio-oh-audiodevicedescriptorarray.md) | OH_AudioDeviceDescriptorArray | 声明音频设备描述符数组。 | 30| [OH_AudioDeviceDescriptor](capi-ohaudio-oh-audiodevicedescriptor.md) | OH_AudioDeviceDescriptor | 声明音频设备描述符。该实例用于获取更多音频设备详细信息属性。 | 31 32### 枚举 33 34| 名称 | typedef关键字 | 描述 | 35| -- | -- | -- | 36| [OH_AudioDevice_ChangeType](#oh_audiodevice_changetype) | OH_AudioDevice_ChangeType | 定义音频设备更改类型。 | 37| [OH_AudioDevice_Role](#oh_audiodevice_role) | OH_AudioDevice_Role | 定义音频设备角色。 | 38| [OH_AudioDevice_Type](#oh_audiodevice_type) | OH_AudioDevice_Type | 定义音频设备类型。 | 39| [OH_AudioDevice_Flag](#oh_audiodevice_flag) | OH_AudioDevice_Flag | 定义音频设备标志。 | 40| [OH_AudioDevice_Usage](#oh_audiodevice_usage) | OH_AudioDevice_Usage | 定义可获取的设备种类。 | 41| [OH_AudioDevice_BlockStatus](#oh_audiodevice_blockstatus) | OH_AudioDevice_BlockStatus | 声明音频设备的堵塞状态。默认情况下，音频设备被视为未堵塞。 | 42 43### 函数 44 45| 名称 | 描述 | 46| -- | -- | 47| [OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceRole(OH_AudioDeviceDescriptor *audioDeviceDescriptor, OH_AudioDevice_Role *deviceRole)](#oh_audiodevicedescriptor_getdevicerole) | 查询目标音频设备描述符的设备角色。 | 48| [OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceType(OH_AudioDeviceDescriptor *audioDeviceDescriptor, OH_AudioDevice_Type *deviceType)](#oh_audiodevicedescriptor_getdevicetype) | 查询目标音频设备描述符的设备类型。 | 49| [OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceId(OH_AudioDeviceDescriptor *audioDeviceDescriptor, uint32_t *id)](#oh_audiodevicedescriptor_getdeviceid) | 查询目标音频设备描述符的设备id。 | 50| [OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceName(OH_AudioDeviceDescriptor *audioDeviceDescriptor, char **name)](#oh_audiodevicedescriptor_getdevicename) | 查询目标音频设备描述符的设备名称。 | 51| [OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceAddress(OH_AudioDeviceDescriptor *audioDeviceDescriptor, char **address)](#oh_audiodevicedescriptor_getdeviceaddress) | 查询目标音频设备描述符的设备地址。 | 52| [OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceSampleRates(OH_AudioDeviceDescriptor *audioDeviceDescriptor, uint32_t **sampleRates, uint32_t *size)](#oh_audiodevicedescriptor_getdevicesamplerates) | 查询目标音频设备描述符的采样率数组。 | 53| [OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceChannelCounts(OH_AudioDeviceDescriptor *audioDeviceDescriptor, uint32_t **channelCounts, uint32_t *size)](#oh_audiodevicedescriptor_getdevicechannelcounts) | 查询目标音频设备描述符的设备通道计数数组。 | 54| [OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceDisplayName(OH_AudioDeviceDescriptor *audioDeviceDescriptor, char **displayName)](#oh_audiodevicedescriptor_getdevicedisplayname) | 查询目标音频设备描述符的显示名称。 | 55| [OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceEncodingTypes(OH_AudioDeviceDescriptor *audioDeviceDescriptor, OH_AudioStream_EncodingType **encodingTypes, uint32_t *size)](#oh_audiodevicedescriptor_getdeviceencodingtypes) | 查询目标音频设备描述符的编码类型数组。 | 56 57## 枚举类型说明 58 59### OH_AudioDevice_ChangeType 60 61``` 62enum OH_AudioDevice_ChangeType 63``` 64 65**描述** 66 67定义音频设备更改类型。 68 69**起始版本：** 12 70 71| 枚举项 | 描述 | 72| -- | -- | 73| AUDIO_DEVICE_CHANGE_TYPE_CONNECT = 0 | 设备连接。 | 74| AUDIO_DEVICE_CHANGE_TYPE_DISCONNECT = 1 | 设备断开。 | 75 76### OH_AudioDevice_Role 77 78``` 79enum OH_AudioDevice_Role 80``` 81 82**描述** 83 84定义音频设备角色。 85 86**起始版本：** 12 87 88| 枚举项 | 描述 | 89| -- | -- | 90| AUDIO_DEVICE_ROLE_INPUT = 1 | 输入设备。 | 91| AUDIO_DEVICE_ROLE_OUTPUT = 2 | 输出设备。 | 92 93### OH_AudioDevice_Type 94 95``` 96enum OH_AudioDevice_Type 97``` 98 99**描述** 100 101定义音频设备类型。 102 103**起始版本：** 12 104 105| 枚举项 | 描述 | 106| -- | -- | 107| AUDIO_DEVICE_TYPE_INVALID = 0 | 无效设备。 | 108| AUDIO_DEVICE_TYPE_EARPIECE = 1 | 内置听筒。 | 109| AUDIO_DEVICE_TYPE_SPEAKER = 2 | 内置扬声器。 | 110| AUDIO_DEVICE_TYPE_WIRED_HEADSET = 3 | 带话筒的耳机。 | 111| AUDIO_DEVICE_TYPE_WIRED_HEADPHONES = 4 | 无话筒的耳机。 | 112| AUDIO_DEVICE_TYPE_BLUETOOTH_SCO = 7 | 使用面向同步连接链路（SCO）的蓝牙设备。 | 113| AUDIO_DEVICE_TYPE_BLUETOOTH_A2DP = 8 | 使用高级音频分布模式（A2DP）的蓝牙设备。 | 114| AUDIO_DEVICE_TYPE_MIC = 15 | 内置麦克风。 | 115| AUDIO_DEVICE_TYPE_USB_HEADSET = 22 | USB音频耳机。 | 116| AUDIO_DEVICE_TYPE_DISPLAY_PORT = 23 | 显示端口（DisplayPort）设备。 | 117| AUDIO_DEVICE_TYPE_REMOTE_CAST = 24 | 音频被系统应用投送到其他远程的设备。 | 118| AUDIO_DEVICE_TYPE_USB_DEVICE = 25 | USB设备（不包含USB耳机）。<br>**起始版本：** 18 | 119| AUDIO_DEVICE_TYPE_ACCESSORY = 26 | 附件设备，如遥控器上的麦克风。<br>**起始版本：** 18 | 120| AUDIO_DEVICE_TYPE_HDMI = 27 | HDMI设备（例如HDMI、ARC、eARC等）。<br>**起始版本：** 19 | 121| AUDIO_DEVICE_TYPE_LINE_DIGITAL = 28 | 有线数字设备（例如S/PDIF等）。<br>**起始版本：** 19 | 122| AUDIO_DEVICE_TYPE_HEARING_AID = 30 | 助听器设备。<br>**起始版本：** 20 | 123| AUDIO_DEVICE_TYPE_NEARLINK = 31 | 星闪设备。<br>**起始版本：** 20 | 124| AUDIO_DEVICE_TYPE_DEFAULT = 1000 | 默认设备类型。 | 125 126### OH_AudioDevice_Flag 127 128``` 129enum OH_AudioDevice_Flag 130``` 131 132**描述** 133 134定义音频设备标志。 135 136**起始版本：** 12 137 138| 枚举项 | 描述 | 139| -- | -- | 140| AUDIO_DEVICE_FLAG_NONE = 0 | 无设备。 | 141| AUDIO_DEVICE_FLAG_OUTPUT = 1 | 输出设备。 | 142| AUDIO_DEVICE_FLAG_INPUT = 2 | 输入设备。 | 143| AUDIO_DEVICE_FLAG_ALL = 3 | 所有设备。 | 144 145### OH_AudioDevice_Usage 146 147``` 148enum OH_AudioDevice_Usage 149``` 150 151**描述** 152 153定义可获取的设备种类。 154 155**起始版本：** 12 156 157| 枚举项 | 描述 | 158| -- | -- | 159| AUDIO_DEVICE_USAGE_MEDIA_OUTPUT = 1 | 媒体输出设备。 | 160| AUDIO_DEVICE_USAGE_MEDIA_INPUT = 2 | 媒体输入设备。 | 161| AUDIO_DEVICE_USAGE_MEDIA_ALL = 3 | 所有媒体设备。 | 162| AUDIO_DEVICE_USAGE_CALL_OUTPUT = 4 | 通话输出设备。 | 163| AUDIO_DEVICE_USAGE_CALL_INPUT = 8 | 通话输入设备。 | 164| AUDIO_DEVICE_USAGE_CALL_ALL = 12 | 所有通话设备。 | 165 166### OH_AudioDevice_BlockStatus 167 168``` 169enum OH_AudioDevice_BlockStatus 170``` 171 172**描述** 173 174声明音频设备的堵塞状态。默认情况下，音频设备被视为未堵塞。 175 176**起始版本：** 13 177 178| 枚举项 | 描述 | 179| -- | -- | 180| AUDIO_DEVICE_UNBLOCKED = 0 | 音频设备未被堵塞。 | 181| AUDIO_DEVICE_BLOCKED = 1 | 音频设备被堵塞。 | 182 183 184## 函数说明 185 186### OH_AudioDeviceDescriptor_GetDeviceRole() 187 188``` 189OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceRole(OH_AudioDeviceDescriptor *audioDeviceDescriptor,OH_AudioDevice_Role *deviceRole) 190``` 191 192**描述** 193 194查询目标音频设备描述符的设备角色。 195 196**起始版本：** 12 197 198 199**参数：** 200 201| 参数项 | 描述 | 202| -- | -- | 203| [OH_AudioDeviceDescriptor](capi-ohaudio-oh-audiodevicedescriptor.md) *audioDeviceDescriptor | 音频设备描述符。通过 [OH_AudioRoutingManager_GetDevices](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_getdevices) 或者[OH_AudioRoutingManager_OnDeviceChangedCallback](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_ondevicechangedcallback)获取。 | 204| [OH_AudioDevice_Role](#oh_audiodevice_role) *deviceRole | 设备角色指针。将设置设备角色值的变量，指向[OH_AudioDevice_Role](#oh_audiodevice_role)。 | 205 206**返回：** 207 208| 类型 | 说明 | 209| -- | -- | 210| [OH_AudioCommon_Result](capi-native-audio-common-h.md#oh_audiocommon_result) | AUDIOCOMMON_RESULT_SUCCESS或AUDIOCOMMON_RESULT_ERROR_INVALID_PARAM。 | 211 212### OH_AudioDeviceDescriptor_GetDeviceType() 213 214``` 215OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceType(OH_AudioDeviceDescriptor *audioDeviceDescriptor,OH_AudioDevice_Type *deviceType) 216``` 217 218**描述** 219 220查询目标音频设备描述符的设备类型。 221 222**起始版本：** 12 223 224 225**参数：** 226 227| 参数项 | 描述 | 228| -- | -- | 229| [OH_AudioDeviceDescriptor](capi-ohaudio-oh-audiodevicedescriptor.md) *audioDeviceDescriptor | 音频设备描述符。通过 [OH_AudioRoutingManager_GetDevices](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_getdevices) 或者[OH_AudioRoutingManager_OnDeviceChangedCallback](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_ondevicechangedcallback)获取。 | 230| [OH_AudioDevice_Type](#oh_audiodevice_type) *deviceType | 设备类型指针。将设置设备类型值的变量，指向[OH_AudioDevice_Type](capi-native-audio-device-base-h.md#oh_audiodevice_type)。 | 231 232**返回：** 233 234| 类型 | 说明 | 235| -- | -- | 236| [OH_AudioCommon_Result](capi-native-audio-common-h.md#oh_audiocommon_result) | AUDIOCOMMON_RESULT_SUCCESS或AUDIOCOMMON_RESULT_ERROR_INVALID_PARAM。 | 237 238### OH_AudioDeviceDescriptor_GetDeviceId() 239 240``` 241OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceId(OH_AudioDeviceDescriptor *audioDeviceDescriptor,uint32_t *id) 242``` 243 244**描述** 245 246查询目标音频设备描述符的设备id。 247 248**起始版本：** 12 249 250 251**参数：** 252 253| 参数项 | 描述 | 254| -- | -- | 255| [OH_AudioDeviceDescriptor](capi-ohaudio-oh-audiodevicedescriptor.md) *audioDeviceDescriptor | 音频设备描述符。通过 [OH_AudioRoutingManager_GetDevices](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_getdevices) 或者[OH_AudioRoutingManager_OnDeviceChangedCallback](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_ondevicechangedcallback)获取。 | 256| uint32_t *id | 设备id指针，将设置设备角色值的变量。 | 257 258**返回：** 259 260| 类型 | 说明 | 261| -- | -- | 262| [OH_AudioCommon_Result](capi-native-audio-common-h.md#oh_audiocommon_result) | AUDIOCOMMON_RESULT_SUCCESS 或 AUDIOCOMMON_RESULT_ERROR_INVALID_PARAM。 | 263 264### OH_AudioDeviceDescriptor_GetDeviceName() 265 266``` 267OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceName(OH_AudioDeviceDescriptor *audioDeviceDescriptor,char **name) 268``` 269 270**描述** 271 272查询目标音频设备描述符的设备名称。 273 274**起始版本：** 12 275 276 277**参数：** 278 279| 参数项 | 描述 | 280| -- | -- | 281| [OH_AudioDeviceDescriptor](capi-ohaudio-oh-audiodevicedescriptor.md) *audioDeviceDescriptor | 音频设备描述符。通过 [OH_AudioRoutingManager_GetDevices](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_getdevices) 或者[OH_AudioRoutingManager_OnDeviceChangedCallback](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_ondevicechangedcallback)获取。 | 282| char **name | 设备名称指针，将设置设备名称值的变量。<br>不要单独释放音频设备名称指针，而是调用[OH_AudioRoutingManager_ReleaseDevices](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_releasedevices)，以便在不再使用时释放所有DeviceDescriptor数组。 | 283 284**返回：** 285 286| 类型 | 说明 | 287| -- | -- | 288| [OH_AudioCommon_Result](capi-native-audio-common-h.md#oh_audiocommon_result) | AUDIOCOMMON_RESULT_SUCCESS或AUDIOCOMMON_RESULT_ERROR_INVALID_PARAM。 | 289 290### OH_AudioDeviceDescriptor_GetDeviceAddress() 291 292``` 293OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceAddress(OH_AudioDeviceDescriptor *audioDeviceDescriptor,char **address) 294``` 295 296**描述** 297 298查询目标音频设备描述符的设备地址。 299 300**起始版本：** 12 301 302 303**参数：** 304 305| 参数项 | 描述 | 306| -- | -- | 307| [OH_AudioDeviceDescriptor](capi-ohaudio-oh-audiodevicedescriptor.md) *audioDeviceDescriptor | 音频设备描述符。通过 [OH_AudioRoutingManager_GetDevices](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_getdevices) 或者[OH_AudioRoutingManager_OnDeviceChangedCallback](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_ondevicechangedcallback)获取。 | 308| char **address | 设备MAC地址指针，将设置设备MAC地址值的变量。<br>不要单独释放音频设备MAC地址指针，而是调用[OH_AudioRoutingManager_ReleaseDevices](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_releasedevices)，以便在不再使用时释放所有DeviceDescriptor数组。 | 309 310**返回：** 311 312| 类型 | 说明 | 313| -- | -- | 314| [OH_AudioCommon_Result](capi-native-audio-common-h.md#oh_audiocommon_result) | AUDIOCOMMON_RESULT_SUCCESS或AUDIOCOMMON_RESULT_ERROR_INVALID_PARAM。 | 315 316### OH_AudioDeviceDescriptor_GetDeviceSampleRates() 317 318``` 319OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceSampleRates(OH_AudioDeviceDescriptor *audioDeviceDescriptor,uint32_t **sampleRates, uint32_t *size) 320``` 321 322**描述** 323 324查询目标音频设备描述符的采样率数组。 325 326**起始版本：** 12 327 328 329**参数：** 330 331| 参数项 | 描述 | 332| -- | -- | 333| [OH_AudioDeviceDescriptor](capi-ohaudio-oh-audiodevicedescriptor.md) *audioDeviceDescriptor | 音频设备描述符。通过 [OH_AudioRoutingManager_GetDevices](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_getdevices) 或者[OH_AudioRoutingManager_OnDeviceChangedCallback](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_ondevicechangedcallback)获取。 | 334| uint32_t **sampleRates | 设置采样率数组值的数组指针变量。<br>不要单独释放音频设备采样率指针，而是调用[OH_AudioRoutingManager_ReleaseDevices](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_releasedevices)，以便在不再使用时释放所有DeviceDescriptor数组。 | 335| uint32_t *size | 设置采样率大小值的指针变量。 | 336 337**返回：** 338 339| 类型 | 说明 | 340| -- | -- | 341| [OH_AudioCommon_Result](capi-native-audio-common-h.md#oh_audiocommon_result) | AUDIOCOMMON_RESULT_SUCCESS或AUDIOCOMMON_RESULT_ERROR_INVALID_PARAM。 | 342 343### OH_AudioDeviceDescriptor_GetDeviceChannelCounts() 344 345``` 346OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceChannelCounts(OH_AudioDeviceDescriptor *audioDeviceDescriptor,uint32_t **channelCounts, uint32_t *size) 347``` 348 349**描述** 350 351查询目标音频设备描述符的设备通道计数数组。 352 353**起始版本：** 12 354 355 356**参数：** 357 358| 参数项 | 描述 | 359| -- | -- | 360| [OH_AudioDeviceDescriptor](capi-ohaudio-oh-audiodevicedescriptor.md) *audioDeviceDescriptor | 音频设备描述符。通过 [OH_AudioRoutingManager_GetDevices](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_getdevices) 或者[OH_AudioRoutingManager_OnDeviceChangedCallback](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_ondevicechangedcallback)获取。 | 361| uint32_t **channelCounts | 数组指针变量，该变量将设置通道计数数组值。<br>不要单独释放音频设备通道数指针，而是调用[OH_AudioRoutingManager_ReleaseDevices](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_releasedevices)，以便在不再使用时释放所有DeviceDescriptor数组。 | 362| uint32_t *size | 设置通道计数大小值的指针变量。 | 363 364**返回：** 365 366| 类型 | 说明 | 367| -- | -- | 368| [OH_AudioCommon_Result](capi-native-audio-common-h.md#oh_audiocommon_result) | AUDIOCOMMON_RESULT_SUCCESS或AUDIOCOMMON_RESULT_ERROR_INVALID_PARAM。 | 369 370### OH_AudioDeviceDescriptor_GetDeviceDisplayName() 371 372``` 373OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceDisplayName(OH_AudioDeviceDescriptor *audioDeviceDescriptor,char **displayName) 374``` 375 376**描述** 377 378查询目标音频设备描述符的显示名称。 379 380**起始版本：** 12 381 382 383**参数：** 384 385| 参数项 | 描述 | 386| -- | -- | 387| [OH_AudioDeviceDescriptor](capi-ohaudio-oh-audiodevicedescriptor.md) *audioDeviceDescriptor | 音频设备描述符。通过 [OH_AudioRoutingManager_GetDevices](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_getdevices) 或者[OH_AudioRoutingManager_OnDeviceChangedCallback](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_ondevicechangedcallback)获取。 | 388| char **displayName | 设置显示名称值的指针变量。<br>不要单独释放音频设备显示名称指针，而是调用[OH_AudioRoutingManager_ReleaseDevices](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_releasedevices)，以便在不再使用时释放所有DeviceDescriptor数组。 | 389 390**返回：** 391 392| 类型 | 说明 | 393| -- | -- | 394| [OH_AudioCommon_Result](capi-native-audio-common-h.md#oh_audiocommon_result) | AUDIOCOMMON_RESULT_SUCCESS或AUDIOCOMMON_RESULT_ERROR_INVALID_PARAM。 | 395 396### OH_AudioDeviceDescriptor_GetDeviceEncodingTypes() 397 398``` 399OH_AudioCommon_Result OH_AudioDeviceDescriptor_GetDeviceEncodingTypes(OH_AudioDeviceDescriptor *audioDeviceDescriptor,OH_AudioStream_EncodingType **encodingTypes, uint32_t *size) 400``` 401 402**描述** 403 404查询目标音频设备描述符的编码类型数组。 405 406**起始版本：** 12 407 408 409**参数：** 410 411| 参数项 | 描述 | 412| -- | -- | 413| [OH_AudioDeviceDescriptor](capi-ohaudio-oh-audiodevicedescriptor.md) *audioDeviceDescriptor | 音频设备描述符。通过 [OH_AudioRoutingManager_GetDevices](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_getdevices) 或者[OH_AudioRoutingManager_OnDeviceChangedCallback](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_ondevicechangedcallback)获取。 | 414| [OH_AudioStream_EncodingType](capi-native-audiostream-base-h.md#oh_audiostream_encodingtype) **encodingTypes | 音频设备编码类型，指向[OH_AudioStream_EncodingType](capi-native-audiostream-base-h.md#oh_audiostream_encodingtype)。<br>不要单独释放音频设备编码类型指针，而是调用[OH_AudioRoutingManager_ReleaseDevices](capi-native-audio-routing-manager-h.md#oh_audioroutingmanager_releasedevices)，以便在不再使用时释放所有DeviceDescriptor数组。 | 415| uint32_t *size | 设置编码类型大小值的指针变量。 | 416 417**返回：** 418 419| 类型 | 说明 | 420| -- | -- | 421| [OH_AudioCommon_Result](capi-native-audio-common-h.md#oh_audiocommon_result) | AUDIOCOMMON_RESULT_SUCCESS或AUDIOCOMMON_RESULT_ERROR_INVALID_PARAM。 | 422 423 424