hdaudio.h) (HDAUDIO_STREAM_FORMAT 结构

项目
02/29/2024

HDAUDIO_STREAM_FORMAT 结构描述捕获或呈现流的数据格式。

语法

typedef struct _HDAUDIO_STREAM_FORMAT {
  ULONG  SampleRate;
  USHORT ValidBitsPerSample;
  USHORT ContainerSize;
  USHORT NumberOfChannels;
} HDAUDIO_STREAM_FORMAT, *PHDAUDIO_STREAM_FORMAT;

成员

SampleRate

指定采样率（以每秒样本为单位）。此成员指示每个频道的播放或录制速率。

ValidBitsPerSample

指定每个样本的有效位数。有效位在容器中保持对齐。有效位右侧的任何未使用的位都必须设置为零。

ContainerSize

指定示例容器的大小（以位为单位）。此成员的有效值为 8、16、24 和 32。

NumberOfChannels

指定音频数据的通道数。对于单声道音频，将此成员设置为 1。对于立体声，将此成员设置为 2。

注解

AllocateCaptureDmaEngine、AllocateRenderDmaEngine 和 ChangeBandwidthAllocation 例程采用HDAUDIO_STREAM_FORMAT结构的输入参数，并输出相应的HDAUDIO_CONVERTER_FORMAT结构。有效HDAUDIO_STREAM_FORMAT值中的信息可以编码为HDAUDIO_CONVERTER_FORMAT值。

此结构类似于 WAVEFORMATEXTENSIBLE 结构，但它省略了 WAVEFORMATEXTENSIBLE 中但与管理连接到 HD 音频控制器的编解码器的任务无关的某些参数。