次の方法で共有

status コマンド

  • [アーティクル]

Note

バイアスフリー通信 Microsoft は、多様で包含的な環境をサポートしています。 このドキュメント内には、"slave" という単語への参照があります。 Microsoft の Bias-Free Communications のスタイル ガイドでは、 これを除外語として認識しています。 この文言は、現在コマンド内で使用されている文言であるために使用されます。 一貫性を保つ目的で、このドキュメントにはこの単語が含まれています。 コマンドでこの単語が変更されると、このドキュメントが配置されるように修正されます。

status コマンドは、デバイスに状態情報を要求します。 すべてのデバイスがこのコマンドを認識します。

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

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

パラメーター

lpszDeviceID

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

lpszRequest

状態情報を要求するためのフラグ。 次の表に、 status コマンドを認識するデバイスの種類と、各種類で使用されるフラグを示します。

デバイスの種類 要求フラグ
cdaudio
  • cdaudio タイプのトラック 番号
  • 現在のトラック
  • length
  • 長さトラック 番号
  • media present
  • mode
  • トラックの数
  • position
  • 位置トラック 番号
  • ready
  • 開始位置
  • 時刻形式
digitalvideo
  • オーディオ
  • オーディオの配置
  • audio bitspersample
  • オーディオの中断
  • audio bytespersec
  • オーディオ入力
  • オーディオ レコード
  • オーディオ ソース
  • audio samplespersec
  • オーディオ ストリーム
  • ベース
  • bitsperpel
  • 輝度
  • color
  • contrast
  • 現在のトラック
  • ディスク領域 ドライブ
  • ファイルの完了
  • ファイル形式
  • ファイル モード
  • 進む
  • フレームがスキップされました
  • gamma
  • input
  • 左ボリューム
  • length
  • 長さトラック 番号
  • media present
  • mode
  • 監視
  • monitor メソッド
  • 公称
  • 名目フレーム レート
  • 名目レコード フレーム レート
  • トラックの数
  • output
  • パレット ハンドル
  • 一時停止モード
  • 再生速度
  • position
  • 位置トラック 番号
  • ready
  • フレーム レートを記録する
  • 参照 フレーム
  • 予約済みサイズ
  • 右ボリューム
  • 正確にシークする
  • シャープネス
  • Smpte
  • 速度
  • 開始位置
  • 引き続きファイル形式
  • 時刻形式
  • 色合い
  • トレブル
  • 未保存
  • video
  • ビデオ キー インデックス
  • ビデオ キーの色
  • ビデオ レコード
  • ビデオ ソース
  • ビデオ ソース番号
  • ビデオ ストリーム
  • ボリューム
  • ウィンドウ ハンドル
  • ウィンドウが表示される
  • 最小化されたウィンドウ
  • ウィンドウが最大化されました
overlay
  • メディアの存在
  • mode
  • トラックの数
  • ready
  • 伸縮
  • ウィンドウ ハンドル
sequencer
  • 現在のトラック
  • 除算の種類
  • length
  • 長さトラック 番号 マスター
  • メディアの存在
  • mode
  • トラックの数
  • offset
  • port
  • position
  • 位置トラック 番号
  • ready
  • スレーブ
  • 開始位置
  • テンポ
  • 時刻形式
ビデオデッキ
  • アセンブル レコード
  • オーディオ モニター
  • オーディオ モニター番号
  • オーディオ レコード
  • オーディオ レコードのトラック 番号
  • オーディオ ソース
  • オーディオ ソース番号
  • channel
  • チャンネルチューナー 番号
  • clock
  • クロック ID
  • counter
  • counter 形式
  • counter resolution
  • 現在のトラック
  • フレーム レート
  • インデックス
  • インデックスオン
  • length
  • 長さトラック 番号
  • メディアの存在
  • メディアの種類
  • mode
  • オーディオ トラックの数
  • トラックの数
  • ビデオ トラックの数
  • 一時停止 タイムアウト
  • 再生形式
  • position
  • 位置の開始
  • 位置トラック 番号
  • postroll duration
  • 電源オン
  • プリロール 期間
  • ready
  • レコード形式
  • 速度
  • 時刻形式
  • 時間モード
  • 時間の種類
  • timecode present
  • タイムコード レコード
  • タイムコードの種類
  • チューナー番号
  • ビデオ モニター
  • ビデオ モニター番号
  • ビデオ 録画
  • ビデオ レコードのトラック 番号
  • ビデオ ソース
  • ビデオ ソース番号
  • 書き込み保護
videodisc
  • 現在のトラック
  • ディスク サイズ
  • 進む
  • length
  • 長さトラック 番号
  • メディアの存在
  • メディアの種類
  • mode
  • トラックの数
  • position
  • 位置トラック 番号
  • ready
  • 側
  • 速度
  • 開始位置
  • 時刻形式
waveaudio
  • 配置 (alignment)
  • bitspersample
  • bytespersec
  • channels
  • 現在のトラック
  • 書式タグ
  • input
  • length
  • 長さトラック 番号
  • レベル
  • media present
  • mode
  • トラックの数
  • output
  • position
  • 位置トラック 番号
  • ready
  • samplespersec
  • 開始位置
  • 時刻形式

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

値 説明
配置 (alignment) データのブロック配置をバイト単位で返します。
アセンブル レコード デバイスがアセンブル モードの記録に設定されている場合は TRUE を 返します。
オーディオ 最新の setaudio "on" または "off" コマンドに応じて、"on" または "off" を返します。 どちらか一方または両方のスピーカーが有効になっている場合は "オン" を返し、それ以外の場合は "オフ" を返します。
オーディオの配置 入力波形オーディオ データの開始に対するデータ ブロックの配置を返します。
audio bitspersample デバイスが記録に使用するサンプルあたりのビット数を返します。 このフラグは、"pcm" アルゴリズムをサポートするデバイスにのみ適用されます。
オーディオの中断 最後の AVI シーケンスのオーディオ部分が分割された回数を返します。 システムは、デバイス ドライバーにオーディオ データを書き込もうとするたびにオーディオ中断をカウントし、ドライバーが使用可能なすべてのデータを既に再生していることを検出します。 このフラグは、MCIAVI デジタル ビデオ ドライバーによってのみ認識されます。 これは、パフォーマンス評価のみを目的としています。戻り値の解釈が困難です。
audio bytespersec 記録に使用される 1 秒あたりの平均バイト数を返します。
オーディオ入力 アナログ入力オーディオ信号のおおよその瞬間オーディオ レベルを返します。 1000 より大きい値は、クリッピングの歪みを意味します。 一部のデバイスでは、オーディオの録音中にのみこの値を返すことができます。 この値には、 set コマンドまたは setaudio コマンドが関連付けされません。
オーディオ モニター "output" または有効なソース入力型のいずれかを返します。 詳細については、 setaudio "monitor" コマンドを参照してください。
オーディオ モニター番号 状態 "オーディオ モニター" で指定された種類の監視対象ビデオ番号を返します。 詳細については、 setaudio コマンドを参照してください。
オーディオ レコード setaudio "record" によって設定された状態を反映して、"on" または "off" を返します。
オーディオ レコードのトラック 番号 オーディオを録音するように VCR が設定されている場合は TRUE を 返します。 トラック番号が指定されていない場合、既定値の 1 が想定されます。
audio samplespersec 記録された 1 秒あたりのサンプル数を返します。
オーディオ ソース 現在のオーディオ デジタイザー ソース "left"、"right"、"average"、または "stereo" を返します。
オーディオ ソース番号 状態 "audio source" によって返される種類のオーディオ ソース番号を返します。 詳細については、 setaudio コマンドを参照してください。
オーディオ ストリーム 現在のオーディオ ストリーム番号を返します。
ベース 現在のオーディオ ベース レベルを返します。
bitsperpel キャプチャまたは記録されたデータを保存するための 1 ピクセルあたりのビット数を返します。
bitspersample サンプルあたりのビット数を返します。
輝度 現在のビデオの明るさレベルを返します。
bytespersec 再生または記録された 1 秒あたりの平均バイト数を返します。
cdaudio タイプのトラック 番号 指定したトラック番号の種類を返します。 これは、"オーディオ" または "その他" にすることができます。
channel チューナに設定されているチャンネルの整数値を返します。
チャンネル・チューナ 番号 「チューナ」 番号 を指定すると、論理チューナ 番号 で現在選択されているチャンネルが返されます。 複数の論理チューナが存在する場合があることに注意してください。
channels チャネル セットの数を返します (モノラルの場合は 1、ステレオの場合は 2)。
clock 外部時刻を返します。 時間は、合計増分を表す符号なし長整数である必要があります。 詳細については、 機能 の "クロック インクリメント レート" コマンドを参照してください。
clock id クロックを識別する一意の整数を返します。
color 現在の色レベルを返します。
contrast 現在のコントラスト レベルを返します。
counter 現在のカウンター形式でカウンター位置を返します。
counter 形式 現在のカウンター形式を返します。 詳細については、 set "counter format" コマンドを参照してください。
counter resolution カウンターの解像度を示す "frames" または "seconds" を返します。 これは精度と同じではありません。
現在のトラック 現在のトラックを返します。MCISEQ シーケンサーは 1 を返します。
ディスク サイズ 読み込まれたディスクのサイズをインチ単位で示す 8 または 12 を返します。
ディスク領域 ドライブ 指定したディスク ドライブの予約コマンドで取得できるおおよそのディスク領域を現在の時刻形式で返します。ドライブは通常、1 文字または 1 文字の後にコロン (:)として指定されます。 ただし、一部のデバイスではパスを使用する場合があります。
除算の種類 次のいずれかのファイル分割の種類を返します。
  • PPQN
  • SMPTE 24 フレーム
  • SMPTE 25 フレーム
  • SMPTE 30 ドロップ フレーム
  • SMPTE 30 フレーム

この情報を使用して、MIDI ファイルの形式とテンポと位置情報の意味を決定します。
ファイルの完了 読み込み、保存、キャプチャ、切り取り、コピー、削除、貼り付け、または元に戻す操作が進行した推定パーセンテージを返します。 (アプリケーションはこれを使用して、進行状況を視覚的に示すことができます)。
ファイル形式 レコードまたは保存コマンドの現在のファイル形式を返します。
ファイル モード "読み込み"、"保存"、"編集中"、または "アイドル状態" を返します。 読み込み操作中に、"読み込み" が返されます。 保存およびキャプチャ操作中に、"保存" が返されます。 切り取り、コピー、削除、貼り付け、または元に戻す操作中に、"編集" を返します。
書式タグ 書式タグを返します。
進む 再生方向が前方にある場合、またはデバイスが再生されていない場合は TRUE を 返します。
フレーム レート デバイスが既定で使用する 1 秒あたりのフレーム数を返します。 NTSC デバイスは、30、PAL 25 などを返します。
フレームがスキップされました 最後の AVI シーケンスが再生されたときに描画されなかったフレームの数を返します。 このフラグは、MCIAVI デジタル ビデオ ドライバーによってのみ認識されます。 これは、パフォーマンス評価のみを目的としています。戻り値の解釈が困難です。
gamma setvideo の "gamma to" 値で設定された値を返します。
インデックス 現在のインデックスの表示を返します。 詳細については、 set "index" コマンドを参照してください。
index on インデックスがオンの場合は TRUE を 返します。
input 入力セットを返します。 設定されていない場合、返されるエラーは、任意のデバイスを使用できることを示します。 デジタル ビデオ デバイスの場合は、入力にのみ適用されるように、"bass"、"treble"、"volume"、"brightness"、"color"、"contrast"、"gamma"、"sharpness"、または "tint" フラグを変更します。 これは、入力を監視する場合の既定値です。
左ボリューム 左側のオーディオ チャネルのボリューム セットを返します。
length メディアの合計長を現在の時刻形式で返します。 PPQN ファイルの場合、長さは曲ポインター単位で返されます。 SMPTE ファイルの場合、 hh:mm:ss:ff として返されます。 hh は時間、 mm は分、 ss は秒、 ff はフレームです。 VCR デバイスの場合、長さは 2 時間です ( set コマンドを使用して長さが明示的に変更されていない限り)。
長さトラック 番号 number で指定されたトラックの長さを時間またはフレーム単位で返します。PPQN ファイルの場合、長さは曲ポインター単位で返されます。 SMPTE ファイルの場合、 hh:mm:ss:ff として返されます。 hh は時間、 mm は分、 ss は秒、 ff はフレームです。
レベル 現在の PCM オーディオ サンプル値を返します。
master 同期セットの種類に応じて、"midi"、"none"、または "smpte" を返します。
media present メディアがデバイスに挿入された場合は TRUE 、それ以外の場合は FALSE を 返します。 Sequencer、video-overlay、digital-video、および waveform-audio デバイスは TRUE を返します。
メディアの種類 メディアの種類を返します。 VCRS の場合、これは "8mm"、"vhs"、"svhs"、"beta"、"Hi8"、"edbeta"、または "other" です。 videodiscs の場合、videodisc の種類に応じて、"CAV"、"CLV"、または "other" になります。
mode デバイスの現在のモードを返します。 すべてのデバイスは、"準備ができていません"、"一時停止"、"再生中"、および "停止" の値を返すことができます。 一部のデバイスでは、追加の "open"、"parked"、"recording"、"seeking" の値を返すことができます。
監視 "file" または "input" を返します。 返される値は、現在のプレゼンテーション ソースを示します。
monitor メソッド "pre"、"post"、または "direct" を返します。 戻り値は、入力監視に使用されるメソッドを示します。
公称 項目は、現在の設定の代わりに名目値を返すように、"bass"、"brightness"、"color"、"contrast"、"gamma"、"sharpness"、"tint"、"treble"、および "volume" フラグを変更します。
名目フレーム レート ファイルに関連付けられている標準フレーム レートを返します。 単位は、1 秒あたりのフレーム数に 1000 を掛けた値です。
名目レコード フレーム レート 入力ビデオ信号に関連付けられている公称フレーム レートを返します。 単位は、1 秒あたりのフレーム数に 1000 を掛けた値です。
オーディオ トラックの数 メディア上のオーディオ トラックの数を返します。
トラックの数 メディア上のトラックの数を返します。 ほとんどの VCR デバイスと同様に、MCISEQ デバイスと MCIWAVE デバイスは 1 を返します。 MCIPIONR デバイスでは、このフラグはサポートされていません。
ビデオ トラックの数 メディア上のビデオ トラックの数を返します。
offset SMPTE ベースのファイルのオフセットを返します。 オフセットは、SMPTE ベースのシーケンスの開始時刻です。 時刻は hh:mm:ss:ff として返されます。ここで、 hh は時間、 mm は分、 ss は秒、 ff はフレームです。
output 現在設定されている出力を返します。 出力が設定されていない場合、返されるエラーは、任意のデバイスを使用できることを示します。 デジタル ビデオ デバイスの場合は、出力にのみ適用されるように、"bass"、"treble"、"volume"、"brightness"、"color"、"contrast"、"gamma"、"sharpness"、または "tint" フラグを変更します。 これは、ファイルを監視する場合の既定値です。
一時停止モード 記録中にデバイスが一時停止されている場合は、"記録" を返します。 再生中にデバイスが一時停止すると、"再生中" が返されます。 デバイスが一時停止されていない場合は、"Action not applicable in current mode" (現在のモードではアクションが適用されません) というエラーが返されます。
一時停止タイムアウト pause コマンドの最大継続時間 (ミリ秒単位) を返します。
再生形式 videotape が再生される形式 (検出可能な場合) を示すコードを返します。"lp"、"ep"、"sp"、または "other" です。 詳細については、「レコード形式」フラグを参照してください。
再生速度 最後の AVI シーケンスの実際の再生時間がターゲットの再生時間とどの程度一致したかを表す値を返します。 値 1000 は、ターゲット時刻と実際の時刻が同じであることを示します。 たとえば、値 2000 は、AVI シーケンスの再生に必要な 2 倍の時間がかかったことを示します。 このフラグは、MCIAVI デジタル ビデオ ドライバーによってのみ認識されます。 これは、パフォーマンス評価のみを目的としています。戻り値の解釈が困難です。
port シーケンスに割り当てられた MIDI ポート番号を返します。
position 現在位置を返します。PPQN ファイルの場合、位置は曲ポインター単位で返されます。 SMPTE ファイルの場合、 hh:mm:ss:ff として返されます。 hh は時間、 mm は分、ss は秒、 ff はフレームです。
位置の開始 使用可能なメディアの開始位置を返します。
位置トラック 番号 number で指定されたトラックの開始位置を返します。 PPQN ファイルの場合、時間形式は曲ポインター単位で返されます。 SMPTE ファイルの場合、 hh:mm:ss:ff として返されます。 hh は時間、 mm は分、 ss は秒、 ff はフレームです。 MCISEQ シーケンサーは 0 を返します。 MCIPIONR デバイスでは、このフラグはサポートされていません。 MCIWAVE デバイスは 0 を返します。
postroll duration 停止または一時停止コマンドが発行されたときに VCR トランスポートをブレーキするために必要な videotape の長さを現在の時刻形式で返します。
電源オン VCR の電源がオンの場合は TRUE を 返します。
プリロール期間 VCR 出力を安定させるために必要な videotape の長さを現在の時刻形式で返します。
ready デバイスが別のコマンドを受け入れる準備ができている場合は TRUE を 返します。
レコード形式 videotape が記録される形式を示すコードを返します。 現在の戻り値の型は、"lp"、"ep"、"sp"、または "other" です。 これらの形式は VHS 固有ではなく、複数の選択可能な記録形式を持つ任意の VCR に適用できます。 "sp" タイプは、最も高速で最高品質の記録形式であり、単一形式の VRS では既定として使用されます。
フレーム レートを記録する 圧縮に使用されるフレーム レートを 1 秒あたりのフレーム数に 1000 を掛けて返します。
参照 フレーム 指定したフレームの前にある最も近いキー フレーム イメージの フレーム番号を返します。
予約済みサイズ 予約済みワークスペースの現在の時刻形式のサイズを返します。 サイズは、完全なワークスペースから圧縮されたデータを再生するのにかかるおおよその時間に対応します。 予約済みのディスク領域がない場合は、0 を返します。 圧縮されたデータの正確なディスク領域は、一般に、データが圧縮されるまで予測できないため、このフラグはおおよそのサイズを返します。
右ボリューム 適切なオーディオ チャネルのボリューム セットを返します。
samplespersec 再生または記録された 1 秒あたりのサンプル数を返します。
正確にシークする "seek exactly" フラグが設定されているかどうかを示す "on" または "off" を返します。
シャープネス デバイスの現在のシャープネス レベルを返します。
側 videodisc のどの側が読み込まれているかを示す 1 または 2 を返します。
スレーブ 同期セットの種類に応じて、"file" 、"midi"、"none"、または "smpte" を返します。
Smpte ワークスペース内の現在の位置に関連付けられている SMPTE タイムコードを返します。 これは dd:dd:dd:dd という形式の文字列で、各 d は 0 から 9 の数字を表します。 ワークスペース データにタイムコード データが含まれていない場合、このフラグは 00:00:00:00 を返します。
速度 デバイスの現在の速度を 1 秒あたりのフレーム数 (または set "speed" コマンドで使用されるのと同じ形式) で返します。 MCIPIONR videodisc プレーヤーでは、このフラグはサポートされていません。
開始位置 メディアの開始位置を返します。
引き続きファイル形式 capture コマンドの現在のファイル形式を返します。
伸縮 ストレッチが有効になっている場合は TRUE を 返します。
テンポ MIDI シーケンスの現在のテンポを現在の時刻形式で返します。 PPQN形式のファイルの場合、テンポは1分あたりのビートです。 SMPTE 形式のファイルの場合、テンポは 1 秒あたりのフレーム数です。
時刻形式 現在の時刻形式を返します。 詳細については、 set コマンドの時刻形式を参照してください。
時間モード 現在位置の時刻モードを返します。 "detect"、"timecode"、または "counter" を指定できます。
時間の種類 使用中の現在の位置の時刻を返します。"timecode" または "counter" です。
timecode present テープの現在位置にタイムコードが記録されている場合は TRUE を 返します。 タイムコードは現在の位置から進む必要があります。 この状態をチェックするには、VCR を再生する必要がある場合があります。
タイムコード レコード VCR がタイムコードを記録するように設定されている場合は TRUE を 返します。
タイムコードの種類 "smpte"、"smpte drop"、"other"、または "none" を返します。 1 秒あたりのフレーム数は状態 "フレーム レート" コマンドから取得でき、デバイスの精度は 機能 "seek accuracy" コマンドによって返されます。
色合い 現在のビデオ濃淡レベルを返します。
トレブル 現在のオーディオトレブル レベルを返します。
チューナー番号 現在の論理チューナー番号を返します。
未保存 閉じる、読み込む、記録する、予約する、切り取り、削除、または貼り付けコマンドの結果として失われる可能性がある、ワークスペースに記録されたデータがある場合は TRUE を返します。 それ以外の場合は FALSE を 返します。
video setvideo コマンドによって設定された状態を反映して、"on" または "off" を返します。
ビデオ キーの色 キーの色の値を返します。
ビデオ キー インデックス キー インデックスの値を返します。
ビデオ モニター "output" または有効なソース入力型のいずれかを返します。 詳細については、 setvideo "monitor" コマンドを参照してください。
ビデオ モニター番号 状態 "ビデオ モニター" によって返される種類の監視対象ビデオ番号を返します。 詳細については、 setvideo コマンドを参照してください。
ビデオ 録画 setvideo "record" によって設定された現在の状態を反映して、"on" または "off" を返します。
ビデオ レコードのトラック 番号 ビデオを録画するように VCR が設定されている場合は TRUE を 返します。 トラック番号が指定されていない場合は、既定値の 1 が想定されます。
ビデオ ソース ビデオ ソースの種類を返します。 詳細については、 setvideo コマンドを参照してください。
ビデオ ソース番号 使用中の種類のビデオ ソースに対応する数値を返します。 たとえば、2 番目の NTSC ビデオ ソース入力が使用されている場合は 2 を返します。
ビデオ ストリーム 現在のビデオ ストリーム番号を返します。
ボリューム 左右のスピーカーに平均音量を返します。 これは、デバイスが再生されていないか、ボリュームが設定されていない場合にエラーを返します。
ウィンドウ ハンドル 戻り値の下位ワードのウィンドウ ハンドルの ASCII 10 進値を返します。
ウィンドウが最大化されました ウィンドウが最大化されている場合は TRUE を 返します。
最小化されたウィンドウ ウィンドウが最小化されている場合は TRUE を 返します。
ウィンドウが表示される ウィンドウが非表示でない場合は TRUE を 返します。
書き込み保護 デバイスが記録できないことを検出した場合 (つまり、書き込み保護がオンの場合) は TRUE を返します。 記録できる場合、または (実際に書き込まずに) 記録できるかどうかを判断できない場合、ドライバーは FALSE を返します。

lpszFlags

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

戻り値

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

解説

位置値を使用するコマンドを発行する前に、set コマンドを使用して目的の時刻形式を 設定 する必要があります。

例

次のコマンドは、"mysound" デバイスの現在のモードを返します。

status mysound mode

要件

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

関連項目

Mci

MCI コマンド文字列

capability

キャプチャ

close

カット

delete

ロード

pause

貼り付け

record

予約

保存

set

setaudio

setvideo

stop

元に戻す