简介CSDN博客专家、《Android系统多媒体进阶实战》作者博主新书推荐《Android系统多媒体进阶实战》Android Audio工程师专栏地址Audio工程师进阶系列【原创干货持续更新中……】Android多媒体专栏地址多媒体系统工程师系列【原创干货持续更新中……】专题一 二AAOS车载系统AOSP14系统攻城狮入门视频实战课专题三Android14 Binder之HIDL与AIDL通信实战课专题四Android15快速自定义与集成音效实战课专题五Android15音频策略实战课专题六Android15音频性能实战课(无声/杂音/断音/爆音实战案例)人生格言人生从来没有捷径只有行动才是治疗恐惧和懒惰的唯一良药.更多原创,欢迎关注Android系统攻城狮文章目录1. 前言2. 用法与应用场景3. 调用流程剖析3.1 核心步骤3.2 涉及核心时序图4. 实战应用案例5. 用法总结1. 前言本篇目的Android tinyalsa之pcm_close调用流程与实战。2. 用法与应用场景pcm_close是tinyalsa库中用于关闭 PCM 设备并释放所有相关资源的终点函数。它不仅负责用户态内存的回收更重要的是触发内核驱动释放物理硬件资源。用法int pcm_close(struct pcm *pcm);返回值成功返回0。若传入指针无效函数会安全返回。应用场景结束音频会话在播放或录音任务完成后正常关闭设备节点。错误处理路径当pcm_open成功但后续的pcm_prepare或数据读写发生严重错误时必须调用此函数进行资源清理。动态路由切换在 Android 系统切换音频路径如 Speaker 切换至有线耳机时HAL 层通常需要关闭当前的 PCM 实例并重新配置。3. 调用流程剖析3.1 核心步骤指针合法性校验检查传入的pcm是否为NULL或指向bad_pcm。tinyalsa的设计确保了对非法句柄调用 close 也不会导致系统崩溃。停止流传输如果设备仍处于RUNNING状态底层驱动会在关闭文件描述符前尝试停止 DMA 传输。解映射 MMAP 缓冲区检查pcm-mmap_buffer。如果用户以PCM_MMAP模式打开设备pcm_close会自动调用munmap释放映射的内存块。触发内核 Release执行系统调用close(pcm-fd)。这会进入内核 ALSA 核心层调用驱动的release回调函数进而关闭硬件功放或重置硬件寄存器。内存释放调用free(pcm)销毁用户态的结构体实例完成最后的清理工作。关键技术坏句柄安全回收tinyalsa在pcm_open失败时也会返回一个结构体fd 为 -1。pcm_close能够识别这种“坏句柄”并仅释放内存而不尝试执行内核关闭操作这简化了 HAL 层的异常处理逻辑。3.2 涉及核心时序图Audio Codec/DMAKernel ALSA CoreVFS (close syscall)tinyalsa (pcm_close)Audio HALAudio Codec/DMAKernel ALSA CoreVFS (close syscall)tinyalsa (pcm_close)Audio HALalt[MMAP 模式已启用]调用 pcm_close(pcm)1. 验证 pcm 指针及状态2. munmap(pcm-mmap_buffer)3. close(pcm-fd)触发 snd_pcm_release停止 DMA, 降低功耗硬件已重置返回4. free(pcm) 释放结构体返回 04. 实战应用案例此 Demo 展示了在 Android HAL 开发中如何规范地使用pcm_close并通过指针置空防止野指针异常。#includetinyalsa/asoundlib.h#includestdio.h#includestdlib.h/** * 模拟 HAL 层安全释放音频流的逻辑 */voidhal_pcm_release(structpcm**pp_pcm){if(pp_pcmNULL||*pp_pcmNULL){return;}/* 1. 执行 tinyalsa 关闭操作 */printf(HAL: Closing pcm device...\n);intretpcm_close(*pp_pcm);if(ret!0){printf(HAL: Warning - pcm_close returned error code %d\n,ret);}/* 2. 极其重要手动将原指针置为 NULL * 防止 HAL 层其他线程误用已释放的内存 (Use-After-Free) */*pp_pcmNULL;printf(HAL: Resource cleanup complete.\n);}intmain(){structpcm_configconfig{.channels2,.rate44100,.period_size1024,.period_count4,.formatPCM_FORMAT_S16_LE};// 打开设备 (声卡 0, 设备 0, 播放模式)structpcm*out_streampcm_open(0,0,PCM_OUT,config);if(out_streampcm_is_ready(out_stream)){printf(HAL: Audio session started.\n);// ... 此处执行音频数据写入 pcm_write ...}// 无论打开成功还是失败最终都要调用清理函数hal_pcm_release(out_stream);return0;}5. 用法总结特性详情描述内存管理完全清理。内部集成了对mmap缓冲区和pcm结构体本身的free。调用配对必须与 pcm_open 配对。漏掉 close 会导致声卡被占用Device Busy以及系统 fd 泄露。线程安全非线程安全。严禁在主线程 close 的同时在另一线程执行pcm_write需在 HAL 层加锁。硬件状态重置硬件。该函数执行后内核通常会关闭相关的 DAC/ADC 电源以节省功耗。容错性高容忍度。可以安全处理未成功 ready 的 pcm 指针不会造成内核异常。