HDAUDIO_STREAM_FORMAT構造体 (hdaudio.h)

[アーティクル]
02/26/2024

HDAUDIO_STREAM_FORMAT構造体は、キャプチャストリームまたはレンダーストリームのデータ形式を表します。

構文

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

メンバー

SampleRate

サンプルレートを 1 秒あたりのサンプル数で指定します。このメンバーは、各チャネルを再生または記録する必要があるレートを示します。

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 オーディオコントローラーに接続されているコーデックを管理するタスクには関係ありません。