MCI_SETAUDIO コマンド

  • [アーティクル]

MCI_SETAUDIO コマンドは、オーディオの再生とキャプチャに関連付けられている値を設定します。 デジタル ビデオおよび VCR デバイスはこのコマンドを認識します。

このコマンドを送信するには、次のパラメーターを指定して mciSendCommand 関数を呼び出します。

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SETAUDIO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpSetAudio
);

パラメーター

wDeviceID

コマンド メッセージを受信する MCI デバイスのデバイス識別子。

dwFlags

MCI_NOTIFY、MCI_WAIT、またはMCI_TEST。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。

lpSetAudio

MCI_GENERIC_PARMS構造体へのポインター。 (拡張コマンド セットを持つデバイスは、この構造体をデバイス固有の構造に置き換える場合があります)。

戻り値

成功した場合は 0 を返し、それ以外の場合はエラーを返します。

解説

digitalvideo デバイスの種類には、次のフラグが適用されます。

MCI_DGV_SETAUDIO_ALG

lpSetAudio によって識別される構造体の lpstrAlgorithm メンバーには、オーディオ圧縮アルゴリズムの名前を含むバッファーのアドレスが含まれています。 圧縮アルゴリズムは、後続の MCI_RESERVE または MCI_RECORD コマンドで使用されます。 使用可能なアルゴリズムは、デバイスによって異なります。 アルゴリズムが現在のファイル形式と互換性がない場合、ファイル形式はアルゴリズムの既定の形式に変更されます。

MCI_DGV_SETAUDIO_CLOCKTIME

指定された時間はミリ秒単位で、MCI_DGV_SETAUDIO_OVERと共に使用する場合は絶対時間です。 (今回は、ワークスペースの再生に関する手順ではありません。

MCI_DGV_SETAUDIO_INPUT

ベース、高音、またはボリューム フラグを変更して、入力信号に影響を与え、記録される内容を変更します。 可能であれば、入力を監視する場合の既定値です。

MCI_DGV_SETAUDIO_ITEM

オーディオ定数は、lpSetAudio によって識別される構造体の dwItem メンバーで指定されます。 定数は、設定されている値を識別します。 次の定数が定義されています。

MCI_DGV_SETAUDIO_AVGBYTESPERSEC

平均バイト数は、lpSetAudio によって識別される構造体の dwValue メンバーで指定されます。 この値は、PCM(パルスコード変調)およびADPCM(アダプティブ差動パルスコード変調)フォーマットで再生または記録するための1秒あたりの平均バイト数を設定します。 ファイルは、この形式で保存されます。

MCI_DGV_SETAUDIO_BASS

オーディオの低周波数レベルは、lpSetAudio によって識別される構造体の dwValue メンバーの係数として指定されます。

MCI_DGV_SETAUDIO_BITSPERSAMPLE

サンプルあたりのビット数は、lpSetAudio によって識別される構造体の dwValue メンバーで指定されます。 この値は、PCM 形式で再生または記録されるサンプルあたりのビット数を設定します。 ファイルは、この形式で保存されます。

MCI_DGV_SETAUDIO_BLOCKALIGN

データ ブロックの配置は、lpSetAudio によって識別される構造体の dwValue メンバーで指定されます。 この値は、入力波形データの開始に対するデータ ブロックの配置を設定します。

MCI_DGV_SETAUDIO_SAMPLESPERSEC

サンプル レートは、lpSetAudio によって識別される構造体の dwValue メンバーで指定されます。 この値は、PCM および ADPCM アルゴリズムを使用した再生と記録のサンプル レートを設定します。 ファイルは、この形式で保存されます。

MCI_DGV_SETAUDIO_SOURCE

オーディオ入力のソースを指定する定数は、lpSetAudio によって識別される構造体の dwValue メンバーに含まれます。 オーディオ入力ソースには、次の定数が定義されています。

MCI_DGV_SETAUDIO_SOURCE_AVERAGE

左右のオーディオ チャネルの平均。

MCI_DGV_SETAUDIO_SOURCE_LEFT

左側のオーディオ チャネル。

MCI_DGV_SETAUDIO_SOURCE_RIGHT

右のオーディオ チャネル。

MCI_DGV_SETAUDIO_SOURCE_STEREO

ステレオ。

MCI_DGV_SETAUDIO_STREAM

オーディオ ストリームは、lpSetAudio によって識別される構造体の dwValue メンバーで指定されます。 整数値は、ワークスペースから再生されるオーディオ ストリームを指定します。 ストリームが指定されていない場合は、物理的にインターリーブされた最初のオーディオ ストリームが再生されます。

MCI_DGV_SETAUDIO_TREBLE

オーディオの高周波数レベルは、lpSetAudio によって識別される構造体の dwValue メンバーの要素として指定されます。

MCI_DGV_SETAUDIO_VOLUME

一方または両方のオーディオ チャネルのオーディオ レベルは、lpSetAudio によって識別される構造体の dwValue メンバーの要素として指定されます。 左右のボリュームが異なる値に設定されている場合、左右のボリュームの比率はほぼ変わりません。

MCI_DGV_SETAUDIO_LEFT

MCI_SET_ONと共に使用する場合は、左側のオーディオ チャネルを有効にします。 MCI_SET_OFFで使用する場合は、左側のオーディオ チャネルを無効にします。 このフラグをMCI_DGV_SETAUDIO_VALUEとMCI_DGV_SETAUDIO_VOLUMEの組み合わせで使用すると、左側のオーディオ チャネルの音量が設定されます。 このフラグをMCI_DGV_SETAUDIO_SOURCEと共に使用すると、オーディオ入力デジタイザーのソースとして左のオーディオ チャネルが指定されます。

MCI_DGV_SETAUDIO_OVER

遷移長パラメーターは、lpSetAudio によって識別される構造体の dwOver メンバーに含まれています。 length 値は、係数を使用する変更を行うために必要な時間 (現在の時刻形式の単位) を指定します。 このフラグを使用しない場合は、変更が直ちに行われます。

MCI_DGV_SETAUDIO_QUALITY

lpSetAudio によって識別される構造体の lpstrQuality メンバーには、オーディオ品質を定義するバッファーのアドレスが含まれています。 バッファー内のテキスト文字列は、オーディオ圧縮アルゴリズムの特性を指定します。

MCI_DGV_SETAUDIO_ALG フラグを使用して、指定したアルゴリズムの品質記述子を選択できます。 このフラグを省略すると、現在のアルゴリズムが使用されます。

使用可能なアルゴリズムと記述子名は、デバイスによって異なります。 各デバイスには、使用可能なアルゴリズムのドキュメントと、該当する記述子名の説明が記載されています。 MCI_QUALITY コマンドでは、追加の記述子名を定義できます。

MCI_DGV_SETAUDIO_RECORD

録音にオーディオ データを含めるか除外するかを指定します。 MCI_SET_ONと組み合わせると、オーディオ データが記録されます。 MCI_SET_OFFと組み合わせると、オーディオ データは除外されます。 既定値にはオーディオ データが含まれます。

MCI_DGV_SETAUDIO_RIGHT

MCI_SET_ONで使用する場合に適切なオーディオ チャネルを有効にします。 MCI_SET_OFFで使用する場合、適切なオーディオ チャネルを無効にします。 このフラグをMCI_DGV_SETAUDIO_VALUEとMCI_DGV_SETAUDIO_VOLUMEの組み合わせで使用すると、適切なオーディオ チャネルの音量が設定されます。

MCI_DGV_SETAUDIO_VALUE

lpSetAudio によって識別される構造体の dwValue メンバーに値を指定します。 値の意味は、MCI_DGV_SETAUDIO_ITEM フラグに定義されている定数によって指定されます。

MCI_SET_OFF

指定したオーディオ チャネルを無効にします。

MCI_SET_ON

指定したオーディオ チャネルを有効にします。

MCI_SETAUDIO_OUTPUT

ベース、高音、またはボリューム フラグを変更して、再生された信号のみを変更し、記録される内容は変更しません。 可能であれば、入力を監視する場合の既定値です。

デジタル ビデオ デバイスの場合、 lpSetAudio パラメーターは MCI_DGV_SETAUDIO_PARMS 構造体を指します。

vcr デバイスの種類では、次の追加フラグが使用されます。

MCI_VCR_SETAUDIO_RECORD

オーディオ録音をオンまたはオフに設定します。これは、次のいずれかのフラグと組み合わせて使用されます。

MCI_SET_ON

オーディオ録音オン。

MCI_SET_OFF

オーディオ録音をオフにします。 オーディオ録音をオフにする前に、まずアセンブル録音をオフにする必要があります ( MCI_VCR_SET_ASSEMBLE_RECORD フラグをオフにした状態で MCI_SET コマンドを使用します)。

MCI_TRACK

lpSetAudio によって識別される構造体の dwTrack メンバーは、コマンドの影響を受けるトラックを指定します。

MCI_VCR_SETAUDIO_SOURCE

オーディオ ソースを設定します。 このフラグは、MCI_VCR_SETAUDIO_TO フラグと共に使用する必要があります。

MCI_VCR_SETAUDIO_MONITOR

オーディオ ソース モニターを設定します。 このフラグは、MCI_VCR_SETAUDIO_TO フラグと共に使用する必要があります。

MCI_VCR_SETAUDIO_TO

lpSetAudio によって識別される構造体の dwTo メンバーには、入力または監視対象の入力の種類を記述する定数が含まれています。 次のいずれかである必要があります。

MCI_VCR_SRC_TYPE_TUNER

種類はチューナーです。

MCI_VCR_SRC_TYPE_LINE

Type は line です。

MCI_VCR_SRC_TYPE_AUX

型は補助型です。

MCI_VCR_SRC_TYPE_GENERIC

型はジェネリックです。

MCI_VCR_SRC_TYPE_MUTE

種類はミュートです。 これは、MCI_VCR_SETAUDIO_SOURCE フラグでのみ使用できます。

MCI_VCR_SRC_TYPE_OUTPUT

型は出力です。

MCI_VCR_SETAUDIO_NUMBER

lpSetAudio によって識別される構造体の dwNumber メンバーには、使用するオーディオ入力 (dwTo メンバーで指定された型) が含まれています。

VCR デバイスの場合、 lpSetAudio パラメーターは MCI_VCR_SETAUDIO_PARMS 構造体を指します。

必要条件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Mmsystem.h (Windows.h を含む)

関連項目

Mci

MCI コマンド