MCI_INFO コマンド

  • [アーティクル]

MCI_INFO コマンドは、デバイスから文字列情報を取得します。 すべてのデバイスでこのコマンドが認識されます。 lpInfo で識別される構造体の lpstrReturn メンバーに情報が返されます。 dwRetSize メンバーは、返されるデータのバッファー長を指定します。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_INFO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_INFO_PARMS) lpInfo
);

パラメーター

wDeviceID

コマンド メッセージを受信する MCI デバイスのデバイス識別子。

dwFlags

MCI_NOTIFY、MCI_WAIT、またはデジタル ビデオおよび VCR デバイスの場合は、MCI_TEST。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。

lpInfo

MCI_INFO_PARMS構造体へのポインター。 (拡張コマンド セットを持つデバイスは、この構造体をデバイス固有の構造に置き換える場合があります)。

戻り値

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

解説

次の追加の標準フラグとコマンド固有フラグは、MCI_INFOをサポートするすべてのデバイスに適用されます。

MCI_INFO_PRODUCT

デバイスに関連付けられているハードウェアの説明を取得します。 デバイスでは、ドライバーと使用されるハードウェアの両方を識別する説明を指定する必要があります。

cdaudio デバイスの種類には、次の追加フラグが適用されます。

MCI_INFO_MEDIA_IDENTITY

クエリ対象のプレーヤーに現在読み込まれているオーディオ CD の一意識別子を生成します。 このフラグは、16 桁の 16 桁の数字の文字列を返します。

MCI_INFO_MEDIA_UPC

オーディオ CD にエンコードされたユニバーサル製品コード (UPC) を生成します。 UPC は数字の文字列です。 すべてのCDで使用できない場合があります。

digitalvideo デバイスの種類には、次の追加フラグが適用されます。

MCI_DGV_INFO_ITEM

lpInfo によって識別される構造体の dwItem メンバーには、必要な情報を示す定数が含 まれます。 デジタル ビデオ デバイスでは、次の定数が定義されています。

MCI_DGV_INFO_AUDIO_ALG

現在のオーディオ圧縮アルゴリズムの名前を返します。

MCI_DGV_INFO_AUDIO_QUALITY

現在のオーディオ品質記述子の名前を返します。

MCI_DGV_INFO_STILL_ALG

現在の静止画像圧縮アルゴリズムの名前を返します。

MCI_DGV_INFO_STILL_QUALITY

現在の静止画像品質記述子の名前を返します。

MCI_DGV_INFO_USAGE

ワークスペース内の視覚データまたは可聴データの所有者によって課される可能性がある使用制限を説明する文字列を返します。

MCI_DGV_INFO_VIDEO_ALG

現在のビデオ圧縮アルゴリズムの名前を返します。

MCI_DGV_INFO_VIDEO_QUALITY

現在のビデオ品質記述子の名前を返します。

MCI_INFO_VERSION

デバイス ドライバーとハードウェアのリリース レベルを返します。 デバイス ドライバー開発者は、返される文字列の構文を文書化する必要があります。

MCI_DGV_INFO_TEXT

ウィンドウ キャプションを取得します。

MCI_INFO_FILE

MCI_OPEN または MCI_LOAD コマンドで指定した最後のファイルのパスとファイル名を取得します。 ファイルが指定されていない場合、デバイスは null で終わる文字列を返します。 このフラグは、MCI_GETDEVCAPS コマンドのMCI_GETDEVCAPS_USES_FILES フラグに TRUE を返すデバイスでのみサポートされます。

デジタル ビデオ デバイスの場合、 lpInfo は MCI_DGV_INFO_PARMS 構造を指します。

シーケンサー デバイスの種類には、次の追加フラグが適用されます。

MCI_INFO_COPYRIGHT

著作権メタ イベントから MIDI ファイルの著作権に関する通知を取得します。

MCI_INFO_FILE

現在のファイルのファイル名を取得します。 このフラグは、MCI_GETDEVCAPS_USES_FILES フラグを指定して MCI_GETDEVCAPS コマンドを呼び出すときに TRUE を返すデバイスでのみサポートされます。

MCI_INFO_NAME

シーケンス/トラック名メタ イベントからシーケンス名を取得します。

次の追加フラグは、 vcr デバイスの種類に適用されます。

MCI_VCR_INFO_VERSION

バージョン番号を指すMCI_INFO_PARMS構造体の lpstrReturn メンバーを設定します。 また、 dwRetSize メンバーを指す文字列の長さと同じに設定します。

オーバーレイ デバイスの種類には、次の追加フラグが適用されます。

MCI_INFO_FILE

現在のファイルのファイル名を取得します。 このフラグは、MCI_GETDEVCAPS コマンドのMCI_GETDEVCAPS_USES_FILES フラグに TRUE を返すデバイスでのみサポートされます。

MCI_OVLY_INFO_TEXT

ビデオ オーバーレイ デバイスに関連付けられているウィンドウのキャプションを取得します。

waveaudio デバイスの種類には、次の追加フラグが適用されます。

MCI_INFO_FILE

現在のファイルのファイル名を取得します。 このフラグは、MCI_GETDEVCAPS_USES_FILES フラグを指定して MCI_GETDEVCAPS コマンドを呼び出すときに TRUE を返すデバイスでサポートされています。

MCI_WAVE_INPUT

現在の入力の製品名を取得します。

MCI_WAVE_OUTPUT

現在の出力の製品名を取得し、その値がデバイス固有です。

必要条件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Mmsystem.h (Windows.h を含む)

関連項目

Mci

MCI コマンド