capability コマンド

capability コマンドは、デバイスの特定の機能に関する情報を要求します。 すべての MCI デバイスはこのコマンドを認識します。

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

_stprintf_s(
  lpszCommand, 
  TEXT("capability %s %s %s"), 
  lpszDeviceID, 
  lpszRequest, 
  lpszFlags
); 

パラメーター

lpszDeviceID

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

lpszRequest

デバイスの機能を識別するフラグ。 次の表に、 機能 コマンドを認識するデバイスの種類と、各種類で使用されるフラグを示します。

値	種類	種類
cdaudio	取り出し可能 再生できます を記録できます を保存できます 複合デバイス	デバイスの種類 (device type) オーディオがある ビデオがある ファイルを使用する
digitalvideo	取り出し可能 フリーズする可能性があります ロック可能 再生できます を記録できます は逆にできます を保存できます ストレッチが可能 入力を引き伸ばすことができます をテストできます	複合デバイス デバイスの種類 (device type) オーディオがある まだ残っている ビデオがある 最大再生速度 最小再生速度 ファイルを使用する パレットを使用する Windows
overlay	取り出し可能 フリーズする可能性があります 再生できます を記録できます を保存できます ストレッチが可能	複合デバイス デバイスの種類 (device type) オーディオがある ビデオがある ファイルを使用する Windows
sequencer	取り出し可能 再生できます を記録できます を保存できます 複合デバイス	デバイスの種類 (device type) オーディオがある ビデオがある ファイルを使用する
ビデオデッキ	長さを検出できます 取り出し可能 フリーズする可能性があります ソースを監視できます 再生できます プリロール可能 プレビュー可能 を記録できます は逆にできます を保存できます をテストできます	クロックインクリメントレート 複合デバイス デバイスの種類 (device type) オーディオがある にクロックがある にタイムコードがある ビデオがある マークの数 シークの精度 ファイルを使用する
videodisc	取り出し可能 再生できます を記録できます は逆にできます を保存できます Cav Clv 複合デバイス	デバイスの種類 (device type) 高速再生レート オーディオがある ビデオあり 通常の再生レート 再生速度が遅い ファイルを使用する
waveaudio	取り出し可能 再生できます を記録できます 保存可能 複合デバイス デバイスの種類 (device type)	オーディオがある ビデオあり inputs outputs ファイルを使用する

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

Flags	説明
長さを検出できます	デバイスがメディアの長さを検出できる場合は TRUE を返します。
取り出し可能	デバイスがメディアを取り出すことができる場合は TRUE を 返します。
フリーズする可能性があります	デバイスがフレーム バッファー内のデータを固定できる場合は TRUE を 返します。
ロック可能	デバイスでデータをロックできる場合は TRUE を 返します。
ソースを監視できます	デバイスが現在の入力選択とは関係なく、監視対象の出力に入力 (ソース) を渡すことができる場合は TRUE を 返します。
再生できます	デバイスが再生できる場合は TRUE を 返します。
プリロールが可能	デバイスがキュー コマンドで "preroll" フラグをサポートしている場合は TRUE を返します。
プレビュー可能	デバイスでプレビューがサポートされている場合は TRUE を 返します。
を記録できます	デバイスが記録をサポートしている場合は TRUE を 返します。
は逆にできます	デバイスが逆再生できる場合は TRUE を 返します。
保存可能	デバイスでデータを保存できる場合は TRUE を 返します。
ストレッチが可能	デバイスが特定の表示四角形を埋めるためにフレームをストレッチできる場合は TRUE を 返します。
入力をストレッチできます	デバイスがフレーム バッファーにデジタル化する過程で画像のサイズを変更できる場合は TRUE を 返します。
をテストできます	デバイスがテスト キーワード (keyword)を認識する場合は TRUE を返します。
Cav	他の項目と組み合わせると、このフラグは、戻り情報が CAV 形式の videodiscs に適用されることを指定します。 videodisc が挿入されない場合は、これが既定値です。
クロックインクリメントレート	外部クロックが 1 秒あたりにサポートするサブ区分の数を返します。 外部クロックがミリ秒クロックの場合、戻り値は 1000 です。 戻り値が 0 の場合、クロックはサポートされません。
clv	他の項目と組み合わせると、このフラグは、戻り値の情報が CLV 形式の videodiscs に適用されることを指定します。
複合デバイス	デバイスが要素名 (ファイル名) をサポートしている場合は TRUE を返します。
デバイスの種類 (device type)	デバイスの種類名を返します。次のいずれかを指定できます。 cdaudio dat digitalvideo other overlay スキャナー sequencer ビデオデッキ videodisc waveaudio
高速再生レート	高速再生速度を 1 秒あたりのフレーム数で返します。デバイスが高速再生できない場合は 0 を返します。
オーディオがある	デバイスがオーディオ再生をサポートしている場合は TRUE を 返します。
にクロックがある	デバイスにクロックがある場合は TRUE を 返します。
まだあります	デバイスが 1 つの画像を持つファイルをモーション ビデオ ファイルよりも効率的に処理する場合は TRUE を 返します。
はタイムコードを持っています	デバイスがタイムコードをサポートできる場合、または不明な場合は TRUE を 返します。
ビデオあり	デバイスがビデオをサポートしている場合は TRUE を 返します。
inputs	入力デバイスの合計数を返します。
最大再生レート	デバイスの最大再生速度 (1 秒あたりのフレーム数) を返します。
最小再生レート	デバイスの最小再生速度 (1 秒あたりのフレーム数) を返します。
通常の再生レート	デバイスの通常の再生速度 (1 秒あたりのフレーム数) を返します。
マークの数	使用できるマークの最大数を返します。0 は、マークがサポートされていないことを示します。
outputs	出力デバイスの合計数を返します。
シークの精度	フレーム内の検索の予想される精度を返します。0 は、デバイスがフレーム精度であることを示し、1 は、デバイスが指定されたシーク位置の 1 つのフレーム内にあると想定していることを示します。
再生速度が遅い	低速再生速度を 1 秒あたりのフレーム数で返します。デバイスの再生速度が遅い場合は 0 を返します。
ファイルを使用する	複合デバイスで使用されるデータ ストレージがファイルである場合は TRUE を 返します。
パレットを使用する	デバイスでパレットが使用されている場合は TRUE を 返します。
Windows	デバイスがサポートできる同時表示ウィンドウの数を返します。

lpszFlags

"wait"、"notify"、またはその両方を指定できます。 デジタル ビデオおよび VCR デバイスの場合は、"テスト" を指定することもできます。 これらのフラグの詳細については、「 待機、通知、テスト フラグ」を参照してください。

戻り値

mciSendString 関数の lpszReturnString パラメーターの情報を返します。 情報は要求の種類によって異なります。

例

次のコマンドは、"mysound" デバイスのデバイスの種類を返します。

capability mysound device type

要件

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

こちらもご覧ください

Mci

MCI コマンド文字列

キュー