list コマンド

list コマンドは、ビデオ入力とオーディオ入力の数と種類を決定します。 デジタル ビデオおよび VCR デバイスはこのコマンドを認識します。

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

_stprintf_s(
  lpszCommand, 
  TEXT("list %s %s %s"), 
  lpszDeviceID, 
  lpszList, 
  lpszFlags
); 

パラメーター

lpszDeviceID

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

lpszList

ビデオ入力とオーディオ入力の数と種類を識別するフラグ。 次の表に、 list コマンドを認識するデバイスの種類と、各種類で使用されるフラグを示します。

値	説明	説明
digitalvideo	オーディオ アルゴリズムオーディオ品質アルゴリズム アルゴリズムオーディオ streamcountnumber インデックス	引き続きアルゴリズム品質 アルゴリズム ビデオ アルゴリズムビデオ品質 アルゴリズム アルゴリズムビデオ ソースビデオ ストリーム
ビデオデッキ	audio source countaudio source number index	ビデオ ソース countvideo ソース番号 インデックス

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

値	説明
オーディオ アルゴリズム	コマンドでオーディオ アルゴリズム名を取得する必要があることを指定します。
オーディオ品質アルゴリズム アルゴリズム	指定した アルゴリズムに関連付けられている品質レベルを取得するコマンドを指定します。 アルゴリズムが "現在" の場合は、現在のアルゴリズムの品質レベルが返されます。
オーディオ ソースの数	オーディオ入力の合計数を返します。
オーディオ ソース番号 インデックス	ソース インデックスのオーディオ入力の種類を返 します。
オーディオ ストリーム	ワークスペースに関連付けられているオーディオ ストリームの名前を取得するコマンドを指定します。 これらの文字列 ("英語" や "ドイツ語" など) はファイルに埋め込まれており、ストリームを識別します。
count	指定した型のオプションの数を返します。
数値 インデックス	指定したオプションの種類の特定のオプション ( インデックスで識別される) を記述する文字列を返します。 インデックス は、1 から "count" によって返される値までの整数である必要があります。
still algorithm	コマンドが引き続きアルゴリズム名を取得する必要があることを指定します。
引き続き品質アルゴリズム アルゴリズム	指定した still アルゴリズムに関連付けられている品質レベルを取得するコマンドを指定します。 アルゴリズムが "現在" の場合は、現在のアルゴリズムの品質レベルが返されます。
ビデオ アルゴリズム	ビデオ アルゴリズム名を取得するコマンドを指定します。
ビデオ品質アルゴリズム アルゴリズム	指定したビデオ アルゴリズムに関連付けられている品質レベルを取得するコマンドを指定します。 アルゴリズムが "現在" の場合は、現在のアルゴリズムの品質レベルが返されます。
ビデオ ソース	ビデオ ソースに関する情報を返すコマンドを指定します。 "count" フラグと共に使用すると、ビデオ ソースの数が返されます。 "number" フラグと共に使用すると、ビデオ ソースの種類が返されます。 MCI では、型に対して"ntsc"、"rgb"、"pal"、"secam"、"svideo"、および "generic" の定数を定義します。 返される各型のソースが複数存在する可能性があります。 "ジェネリック" ソースの種類は、そのコネクタに対して複数の信号が許可されている場合に使用されます。
ビデオ ソースの数	ビデオ入力の合計数を返します。
ビデオ ソース番号 インデックス	ソース インデックスのビデオ入力の種類を返 します。
ビデオ ストリーム	ワークスペースに関連付けられているビデオ ストリームの名前を取得するコマンドを指定します。 これらの文字列 ("面白い終了" や "悲しい終わり" など) はファイルに埋め込まれており、ストリームを識別します。

lpszFlags

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

戻り値

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

注釈

VCR デバイスの場合、"ビデオ ソース" または "オーディオ ソース" を "count" フラグまたは "number" フラグで指定する必要があります。 "count" を指定すると、ビデオまたはオーディオの入力の合計数が返されます。 "number" が指定されている場合、ドライバーは入力に対応する型を返します。 種類は、"チューナー"、"line"、"svideo"、"aux"、または "generic" のいずれかです。 通常は、最初に "count" の VCR に対してクエリを実行し、そのカウントを "number" フラグの範囲として使用する必要があります。 "ソース" 番号は 1 から始まります。

要件

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

こちらもご覧ください

Mci

MCI コマンド文字列