HDAUDIO_STREAM_FORMAT結構 (hdaudio.h)

發行項
03/01/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值。

此結構類似於「要求」XTENSIBLE 結構，但它會省略於在「顯示」中之特定參數，但與管理連線至 HD 音訊控制器的編解碼器工作無關。