MCI コマンドの分類
[MCI このページに関連付けられている機能は、従来の機能です。 これは、MediaPlayerに置き換えられます。 MediaPlayer は、Windows 10 および Windows 11 用に最適化されています。 新しいコードでは、可能な場合は、MCI ではなく、MediaPlayer 使用することを強くお勧めします。 従来の API を使用する既存のコードは、可能であれば新しい API を使用するように書き直すよう提案しています。
MCI では、システム、必須、基本、拡張の 4 つのコマンド分類が定義されています。 次の一覧では、これらのコマンドの分類について説明します。
- システム コマンド は、ドライバーではなく MCI によって直接処理されます。
- 必要なコマンド は、ドライバーによって処理されます。 すべての MCI ドライバーは、必要なコマンドとフラグをサポートする必要があります。
- 基本コマンド (または省略可能なコマンド) は、一部のデバイスで使用されます。 デバイスが基本コマンドをサポートしている場合は、そのコマンドに対して定義されたフラグのセットをサポートする必要があります。
- 拡張コマンド は、デバイスの種類またはドライバーに固有です。 拡張コマンドには、put (MCI_PUT) や、digitalvideo と オーバーレイ デバイスの種類の (MCI_WHERE) コマンド、既存のコマンド (オーバーレイ デバイスの種類の 状態 (MCI_STATUS) コマンドの "stretch" フラグなど) の拡張機能などのコマンドが含まれます。
システム コマンドと必須コマンドは MCI ドライバーの最小コマンド セットですが、基本コマンドと拡張コマンドはすべてのドライバーでサポートされているわけではありません。 アプリケーションでは、システムと必要なコマンドとそのフラグを常に使用できますが、基本コマンドまたは拡張コマンドまたはフラグを使用する必要がある場合は、最初に 機能 (MCI_GETDEVCAPS) コマンドを使用してドライバーにクエリを実行する必要があります。 次のセクションでは、各カテゴリの特定のコマンドの概要を示します。
システム コマンド
MCI は、MCI デバイスに渡すのではなく、次のシステム コマンドを直接処理します。
糸 | メッセージ | 形容 |
---|---|---|
中断 | MCI_BREAK | MCI デバイスのブレーク キーを設定します。 |
sysinfo を する | MCI_SYSINFO | MCI デバイスに関する情報を返します。 |
必要なコマンド
すべての MCI デバイスは、次の必須コマンドをサポートします。
糸 | メッセージ | 形容 |
---|---|---|
機能の | MCI_GETDEVCAPS | デバイスの機能を取得します。 |
を閉じる | MCI_CLOSE | デバイスを閉じます。 |
情報 | MCI_INFO | デバイスからテキスト情報を取得します。 |
を開 | MCI_OPEN | デバイスを初期化します。 |
状態の | MCI_STATUS | デバイスから状態情報を取得します。 このコマンドのフラグの一部は必須ではないため、基本的なコマンドでもあります。 |
デバイスでは、必要なコマンドの標準のコマンド フラグのセットもサポートする必要があります。
基本的なコマンド
次の一覧は、基本的なコマンドをまとめたものです。 MCI デバイスによるこれらのコマンドの使用は省略可能です。
糸 | メッセージ | 形容 |
---|---|---|
読み込み | MCI_LOAD | ファイルからデータを読み込みます。 |
一時停止 | MCI_PAUSE | 再生を停止します。 再生または記録は、現在の位置で再開できます。 |
プレイ | MCI_PLAY | 出力データの送信を開始します。 |
レコード | MCI_RECORD | 入力データの記録を開始します。 |
再開 | MCI_RESUME | 一時停止しているデバイスでの再生または記録を再開します。 |
保存 | MCI_SAVE | データをディスク ファイルに保存します。 |
シーク | MCI_SEEK | 前方または後方をシークします。 |
セット | MCI_SET | デバイスの動作状態を設定します。 |
状態の | MCI STATUSの | デバイスに関する状態情報を取得します。 これは必須のコマンドでもあります。フラグの一部は必須ではないため、ここにも一覧表示されます。 (省略可能な項目は、特定可能な位置で線形メディアを使用するデバイスをサポートします)。 |
停止 | MCI_STOP | 再生を停止します。 |
ドライバーが基本的なコマンドをサポートしている場合は、コマンドの標準のフラグ セットもサポートする必要があります。
拡張コマンド
MCI デバイスによっては、コマンドが追加されたり、既存のコマンドにフラグが追加されたりします。 一部の拡張コマンドは特定のデバイス ドライバーにのみ適用されますが、そのほとんどは特定の種類のデバイスのすべてのドライバーに適用されます。 たとえば、デバイスタイプ シーケンサーのコマンドセットは、セット(MCI_SET)コマンドを拡張して、MIDI シーケンサーに必要な時間形式を追加します。
デバイスが拡張コマンドまたはフラグをサポートしていると想定しないでください。 機能 (MCI_GETDEVCAPS) コマンドを使用して、特定の機能がサポートされているかどうかを判断し、アプリケーションで "サポートされていないコマンド" または "サポートされていない関数" の戻り値を処理する準備ができている必要があります。
次の拡張コマンドは、一覧表示されているデバイスの種類で使用できます。
糸 | メッセージ | デバイスの種類 | 形容 |
---|---|---|---|
構成する | MCI_CONFIGURE | digitalvideo | 構成ダイアログ ボックスを表示します。 |
キューをする | MCI_CUE | digitalvideo, waveaudio | 再生または記録の準備をします。 |
削除 | MCI_DELETE | waveaudio | メディア ファイルからデータ セグメントを削除します。 |
エスケープ | MCI_ESCAPE | videodisc | デバイスにカスタム情報を送信します。 |
フリーズ | MCI_FREEZE | オーバーレイ | フレーム バッファーへのビデオの取得を無効にします。 |
を配置 | MCI PUTをする | digitalvideo, オーバーレイ | ソース ウィンドウ、変換先ウィンドウ、フレーム ウィンドウを定義します。 |
を実現 | MCI_REALIZE | digitalvideo | 表示されるウィンドウのデバイス コンテキストにそのパレットを選択して実現するようにデバイスに指示します。 |
setaudioをする | SETAUDIOのMCI_ | digitalvideo | ビデオのオーディオ パラメーターを設定します。 |
setvideoをする | SETVIDEOのMCI_ | digitalvideo | ビデオ パラメーターを設定します。 |
信号 | MCI_SIGNAL | digitalvideo | 指定した位置をシグナルで識別します。 |
スピン | MCI_SPIN | videodisc | ディスクの回転を開始するか、ディスクの回転を停止します。 |
手順の | MCI_STEP | digitalvideo, videodisc | 1 つ以上のフレームを前後に再生します。 |
の凍結解除をする | MCI_UNFREEZE | オーバーレイ | フレーム バッファーがビデオ データを取得できるようにします。 |
更新 | MCI_UPDATE | digitalvideo | 現在のフレームをデバイス コンテキストに再描画します。 |
の場所をする | MCI WHERE | digitalvideo, オーバーレイ | ソース、宛先、またはフレーム領域を指定する四角形を取得します。 |
ウィンドウの | MCI_WINDOW | digitalvideo, オーバーレイ | 表示ウィンドウを制御します。 |