setaudio コマンド

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

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

_stprintf_s(
  lpszCommand, 
  TEXT("setaudio %s %s %s"), 
  lpszDeviceID, 
  lpszAudio, 
  lpszFlags
); 

パラメーター

lpszDeviceID

MCI デバイスの識別子。 この識別子またはエイリアスは、デバイスを開いたときに割り当てられます。

lpszAudio

オーディオの再生とキャプチャにフラグを設定します。 次の表に、 setaudio コマンドを認識するデバイスの種類と、各種類で使用されるフラグを示します。

値	説明	説明
digitalvideo	アルゴリズム アルゴリズムを 整数ベースに配置して bitspersample を 要素化し、バイトを bit_count バイト/秒から 整数のクロックタイム入力を左ボリュームで左に残して出力時に 考慮する	期間品質記述子レコードオフレコードオフレコードを右のボリュームで右オフにして、サンプルを因子化します。整数ソースからソース名へのストリームに対して、ボリュームを因数化するために高音に変換する
ビデオデッキ	オフモニターでレコードレコードオフレコード番号を入力track_numberオフ	レコードトラックのレコードtrack_numberをソースに入力して、番号トラックtrack_numberオフトラックtrack_numberを入力する

次の表に、 lpszAudio パラメーターで指定できるフラグとその意味を示します。

値	説明
アルゴリズム アルゴリズム	後続の 予約 または レコード コマンドで使用する特定のオーディオ圧縮アルゴリズムを選択します。 サポートされているアルゴリズムはデバイス固有です。 MCI では、 アルゴリズムの値 "g711"、"g721"、"g722"、"g728"、"pcm"、"cdxa"、"adpcm"、および "adpcm4e" を定義します。 デバイスがアルゴリズム名 "pcm"、"cdxa"、および "adpcm4e" をサポートしている場合は、標準定義に従います。 "cdxa" アルゴリズムは、ソニー株式会社によって定義されています。 "adpcm4e" アルゴリズムは Intel Corporation によって定義されています。 "g711"、"g721"、"g722"、および "g728" の値は、国際電信電話相談委員会 (CCITT) によって推奨されるオーディオ アルゴリズムを表します。 指定したアルゴリズムが現在のファイル形式と競合する場合、ファイル形式はアルゴリズムの既定の形式に変更されます。
整数への配置	入力波形オーディオ データの開始位置に対するデータ ブロックの配置を設定します。
ベースから 係数	オーディオの低周波数レベルを設定します。
bitspersample から bit_count	記録されるサンプルあたりのビット数を設定します。 ファイルは、この形式で保存されます。 このフラグは、"pcm" アルゴリズムをサポートするデバイスにのみ適用されます。
bytespersec から integer	"pcm" アルゴリズムと "adpcm" アルゴリズムでの記録の 1 秒あたりの平均バイト数を設定します。 ファイルは、この形式で保存されます。
clocktime	"over" フラグで指定された時間がミリ秒単位であることを示します。 この時間は絶対であり、ワークスペースの再生に伴うステップではありません。
input	"bass"、"treble"、または "volume" フラグを変更して、入力信号に影響を与え、記録される内容を変更します。 可能であれば、入力を監視する場合の既定値です。
左から左へ	左側のチャネルでオーディオ出力を有効または無効にします。 オーディオ プレゼンテーション ソースには、外部入力またはワークスペースを指定できます。 既定値は "left on" です。 チャネルが 1 つしかない場合、そのチャネルはオンまたはオフに設定されます。
左ボリュームから 係数	左側のオーディオ チャネルのオーディオ ボリュームを設定します。 チャネルが 1 つしかない場合は、そのボリュームが設定されます。
番号を入力するモニター	録音ソース入力の選択を変更せずに、VCR 出力に渡されるソース入力を制御します。 型 には、"出力" または有効な入力ソースの 1 つを指定できます。 number が指定されていない場合は、その型の最初の入力が選択されます。
off on	オーディオを有効または無効にします。 オーディオ プレゼンテーション ソースには、外部入力またはワークスペースを指定できます。 このコマンドは、左右のオーディオ チャンネルに同時に影響します。 既定値は setaudio "on" です。
output	"bass"、"treble"、または "volume" フラグを変更して、再生された信号のみを変更し、記録される内容を変更しないようにします。 可能であれば、ファイルを監視する場合の既定値です。
期間を超える	因子変数を使用する変更に要する時間を指定します。 期間の単位は現在の時刻形式です。 変更は、ワークスペースの再生に伴うステップで行われます。 再生が中断されると、プレイが続行されるまで変更も中断されます。 "over" が指定されていないか、サポートされていない場合、変更はすぐに行われます。
品質 記述子	オーディオがファイルに記録されるときに実行されるオーディオ圧縮の特性を指定します。 すべてのデバイスは、"low"、"medium"、"high" の 3 つの記述子をサポートします。 既定値はデバイス固有です。"algorithm" フラグが指定されていない場合、"品質" 調整は現在のアルゴリズムに適用されます。 quality コマンドを使用して、追加の記述子名を定義できます。
レコードオフ	次の record コマンドでオーディオが記録されないように、オーディオ ソースの選択をクリアします。
レコードオン	オーディオ データの記録を有効にします。 既定では、オーディオ データを記録します。
レコードトラック track_number オフ	次の record コマンドでオーディオが記録されないように、オーディオ ソースの選択をクリアします。 「トラック」は独立したトラック選択を可能にする。 トラック2はHi8のPCMトラックに対応しています。 "track" が指定されていない場合は、既定値の 1 が想定されます。
レコード トラック track_number	次の record コマンドで録音するオーディオ ソースを選択します。 「トラック」は独立したトラック選択を可能にする。 トラック2はHi8のPCMトラックに対応しています。 "track" が指定されていない場合は、既定値の 1 が想定されます。
右から右	適切なチャネルでオーディオ出力を有効または無効にします。 オーディオ プレゼンテーション ソースには、外部入力またはワークスペースを指定できます。 既定値は "右オン" です。 チャネルが 1 つしかない場合、このフラグは無効です。
右ボリュームを考慮する	オーディオ ボリュームを適切なオーディオ チャネルに設定します。 チャネルが 1 つしかない場合、効果はありません。
samplespersec から integer	"pcm" アルゴリズムと "adpcm" アルゴリズムを使用して記録するサンプル レートを設定します。 ファイルはこの形式で保存されます。
source から sourcename へ	オーディオ入力デジタイザーのソースを指定します。 sourcename に定義されている定数には、"left"、"right"、"average"、"stereo" があります。 最初の 3 つでは、左入力のみ、右入力のみ、および 2 つの入力の平均を使用して、モノフォニック録音を指定します。
数値を入力するソース	テープに記録するオーディオ ソースを選択します。 種類 は、"tuner"、"line"、"svideo"、"aux"、"generic"、または "mute" である必要があります。
stream to number	ワークスペースから再生されるオーディオ ストリームを指定します。 ストリームが指定されておらず、ファイル形式で既定値が定義されていない場合は、物理的に最初に再生されるインターリーブオーディオストリームが再生されます。
トラックtrack_numberオフ	個々のトラックを無効にします。
でtrack_numberを追跡する	個々のトラックを有効にします。
treble to factor	オーディオの高周波数レベルを設定します。
ボリュームを係数に設定する	両方のオーディオ チャネルの平均オーディオ ボリュームを設定します。 左右のボリュームが異なる値に設定されている場合、左から右へのボリュームの比率はほぼ変わりません。

lpszFlags

"wait"、"notify"、"test"、またはこれらの組み合わせを指定できます。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。

戻り値

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

注釈

VCR デバイスの場合、setaudio を使用して個々のトラックをオフにするフラグ ("トラック track_number オフ") を使用すると、コマンドを実行できなかったことを示すステータス メッセージがアプリケーションで受信される可能性があります。一部の VCR では、個々のトラックではなく、トラックの組み合わせのみをオフにできます。たとえば、ビデオ カセットの最初のオーディオ トラックやビデオ トラックなどです。 この場合は、setaudio と setvideo を使用して、組み合わせを構成する他のトラックをオフにし続けます。 ドライバーは、組み合わせの最後のトラックをオフにするコマンドを受け取ったときにトラックをオフにします。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]

こちらもご覧ください

Mci

MCI コマンド文字列

record

予約

setvideo