info コマンド

info コマンドは、デバイスからハードウェアの説明を取得します。 すべての MCI デバイスがこのコマンドを認識します。

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

_stprintf_s(
  lpszCommand, 
  TEXT("info %s %s %s"), 
  lpszDeviceID, 
  lpszInfoType, 
  lpszFlags
); 

パラメーター

lpszDeviceID

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

lpszInfoType

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

値	説明	説明
cdaudio	info identityinfo upc	product
digitalvideo	audio algorithmaudio qualityfileproductstill algorithmstill quality	usageversionvideo algorithmvideo qualitywindow text
overlay	fileproduct	ウィンドウ テキスト
sequencer	copyrightfile	nameproduct
ビデオデッキ	product	version
videodisk	product
waveaudio	fileinput	outputproduct

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

値	説明
オーディオ アルゴリズム	現在のオーディオ圧縮アルゴリズムの名前を返します。
オーディオ品質	現在のオーディオ品質記述子の名前を返します。 アプリケーションが定義された品質に対応しない特定の値にパラメーターを設定している場合、これは "不明" を返す可能性があります。
著作権	著作権メタ イベントから MIDI ファイルの著作権に関する通知を取得します。
file	複合デバイスで使用されるファイルの名前を取得します。 ファイルなしでデバイスを開き、 load コマンドが使用されていない場合は、null 文字列が返されます。
情報 ID	クエリ対象のプレーヤーに現在読み込まれているオーディオ CD の一意識別子を生成します。
info upc	オーディオ CD でエンコードされたユニバーサル製品コード (UPC) を生成します。 UPC は数字の文字列です。 一部のCDでは使用できない場合があります。
input	現在の入力デバイスの説明を取得します。 入力デバイスが設定されていない場合は、"none" を返します。
name	シーケンス/トラック名メタ イベントからシーケンス名を取得します。
output	現在の出力デバイスの説明を取得します。 出力デバイスが設定されていない場合は、"none" を返します。
product	デバイスの説明を取得します。 多くの場合、この情報には製品名とモデルが含まれます。 文字列の長さは 31 文字以下です。
引き続きアルゴリズム	現在の静止画像圧縮アルゴリズムの名前を返します。
引き続き品質	現在の静止画像品質記述子の名前を返します。 アプリケーションが定義された品質に対応しない特定の値にパラメーターを設定している場合、これは "不明" を返す可能性があります。
usage	ワークスペース内のビジュアルまたはオーディオ データの所有者によって適用される可能性がある使用制限を説明する文字列を返します。
version	デバイス ドライバーとハードウェアのリリース レベルを返します。
ビデオ アルゴリズム	現在のビデオ圧縮アルゴリズムの名前を返します。
ビデオ品質	現在のビデオ品質記述子の名前を返します。 アプリケーションが定義された品質に対応しない特定の値にパラメーターを設定している場合、これは "不明" を返す可能性があります。
ウィンドウ テキスト	デバイスで使用されるウィンドウのキャプションを取得します。

lpszFlags

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

戻り値

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

例

次のコマンドは、"mysound" デバイスに関連付けられているハードウェアの説明を取得します。

info mysound product

必要条件

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

関連項目

Mci

MCI コマンド文字列

ロード