3. ALSA 核心数据结构：snd_card、snd_pcm、snd_control、snd_rawmidi 结构体解析

ALSA 驱动层的核心围绕四个关键数据结构展开：snd_card（声卡实例）、snd_pcm（PCM 设备）、snd_control（控制接口）和 snd_rawmidi（MIDI 设备）。理解这些结构体的层次关系与内部字段，是编写正确 ALSA 驱动的第一步。

3.1 snd_card：声卡实例的根容器

snd_card 是 ALSA 驱动中最高层级的抽象，代表一个物理或逻辑声卡。每个声卡驱动在 probe 阶段必须首先创建并注册一个 snd_card 实例。

3.2 snd_pcm：音频数据流的核心引擎

snd_pcm 是 ALSA 中最重要的子设备，负责管理音频数据的播放（playback）和录音（capture）。每个 snd_pcm 实例包含两个独立的 substream 链表：一个用于 playback，一个用于 capture。

3.3 snd_control：用户空间的调节旋钮

snd_control 是 ALSA 控制接口的内核表示，用户通过 alsamixer、amixer 或 alsactl 操作的就是这些 control 实例。每个 control 可以是一个音量滑块、开关或枚举选择器。

struct snd_kcontrol {
    struct list_head list;           // 挂入 snd_card 的 controls 链表
    struct snd_ctl_elem_id id;       // 控制元素标识（name, index, numid）
    unsigned int count;              // 该控制器的元素个数
    struct snd_kcontrol_volatile volatile[SNDRV_CTL_ELEM_ID_MAX_ELEMS];
    struct snd_kcontrol_ops *ops;    // 回调函数：info, get, put, tlv
    void *private_data;              // 驱动私有数据
    unsigned int private_value;      // 常用整型私有值
};

3.4 snd_rawmidi：MIDI 设备的抽象

snd_rawmidi 结构体用于管理 MIDI 输入/输出设备。与 snd_pcm 类似，它也包含独立的 substream 用于输入和输出方向。

struct snd_rawmidi {
    struct snd_card *card;           // 所属声卡
    struct list_head list;           // 挂入 snd_card 的 rawmidi 链表
    unsigned int device;             // 设备索引
    unsigned int info_flags;         // 设备能力标志
    struct snd_rawmidi_ops *ops;     // 硬件操作回调
    struct snd_rawmidi_substream *substreams[2]; // 0=输出, 1=输入
    void *private_data;
    char name[32];
};

3.5 四种核心结构体的对比总结