MCI_LIST コマンド

  • [アーティクル]

MCI_LIST コマンドを使うと、デバイスで使用できる入力の数と型に関する情報を取得できます。 デジタルビデオおよび VCR デバイスはこのコマンドを認識します。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_LIST, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpList
);

パラメーター

wDeviceID

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

dwFlags

MCI_NOTIFY、MCI_WAIT、または MCI_TEST。 これらのフラグの詳細については、「待機、通知、およびテスト フラグ」を参照してください。

lpList

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

戻り値

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

解説

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

MCI_DGV_LIST_ALG

lpList で特定される構造体の lpstrAlgorithm メンバーには、アルゴリズムの名前を含むバッファーのアドレスが含まれています。 この名前は、アルゴリズムに関連付けられている品質記述子の種類を取得するために使われます。

MCI_DGV_LIST_COUNT

指定した型のオプション数を返します。

MCI_DGV_LIST_ITEM

リストの種類を示す定数は、lpList で特定された構造体の dwItem メンバーに含まれています。 このフラグは必須です。 リストの種類を示すには、次の定数のいずれかを使います。

MCI_DGV_LIST_AUDIO_ALG

このコマンドを使うと、オーディオ アルゴリズムの名前が取得されます。

MCI_DGV_LIST_AUDIO_QUALITY

このコマンドを使うと、オーディオ品質レベルが取得されます。 返されるレベルは、lpList で特定された構造体の lpstrAlgorithm メンバーから参照されるアルゴリズムに関連付けられます。 そのメンバーを文字列 "current" を使って指定した場合、現在のアルゴリズムに関連付けられている品質が返されます。

MCI_DGV_LIST_AUDIO_STREAM

このコマンドを使うと、オーディオ ストリームの名前が取得されます。

MCI_DGV_LIST_STILL_AL

このコマンドを使うと、静止画像アルゴリズムの名前が取得されます。

MCI_DGV_LIST_STILL_QUALITY

このコマンドを使うと、品質レベルが取得されます。 返されるレベルは、lpList で特定された構造体の lpstrAlgorithm メンバーから参照されるアルゴリズムに関連付けられます。 そのメンバーを文字列 "current" を使って指定した場合、現在のアルゴリズムに関連付けられている品質が返されます。

MCI_DGV_LIST_VIDEO_ALG

このコマンドを使うと、ビデオ アルゴリズムの名前が取得されます。

MCI_DGV_LIST_VIDEO_QUALITY

このコマンドを使うと、ビデオ品質レベルが取得されます。 返されるレベルは、lpList で特定された構造体の lpstrAlgorithm メンバーから参照されるアルゴリズムに関連付けられます。 そのメンバーを文字列 "current" を使って指定した場合、現在のアルゴリズムに関連付けられている品質が返されます。

MCI_DGV_LIST_VIDEO_SOURCE

このコマンドを使うと、ビデオ ソースに関する情報が返されます。 MCI_DGV_LIST_COUNT と共に使うと、コマンドからビデオ ソース数が返されます。 MCI_DGV_LIST_NUMBER と共に使うと、コマンドからビデオ ソースの種類が返されます。 MCI には次の種類が定義されています。

  • MCI_DGV_SETVIDEO_SRC_GENERIC
  • MCI_DGV_SETVIDEO_SRC_NTSC
  • MCI_DGV_SETVIDEO_SRC_PAL
  • MCI_DGV_SETVIDEO_SRC_RGB
  • MCI_DGV_SETVIDEO_SRC_SECAM
  • MCI_DGV_SETVIDEO_SRC_SVIDEO

返される各種類のソースが複数存在する可能性があります。 汎用ソースの種類は、そのコネクタでさまざまなシグナルが許可されている場合に使われます。

MCI_DGV_LIST_VIDEO_STREAM

このコマンドを使うと、ビデオ ストリームの名前が取得されます。

MCI_DGV_LIST_NUMBER

インデックスは、lpList で特定された構造体の dwNumber メンバーで指定されます。 インデックスは、1 から MCI_DGV_LIST_COUNT フラグに対して返される値までの整数にする必要があります。

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

以下に示すその他のフラグは、digitalvideo デバイスの種類に適用されます。

MCI_VCR_LIST_AUDIO_SOURCE

オーディオの入力または種類を一覧表示します。

MCI_VCR_LIST_COUNT

lpList で特定された構造体の dwReturn メンバーを、ビデオまたはオーディオ入力の合計数に設定します。

MCI_VCR_LIST_NUMBER

lpList で特定された構造体の dwReturn メンバーを、dwNumber メンバーで指定されたビデオまたはオーディオ入力の種類に設定します。

MCI_VCR_LIST_VIDEO_SOURCE

ビデオの入力または種類を一覧表示します。

VCR デバイスの場合、lpList は MCI_VCR_LIST_PARMS 構造体を指します。

要件

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

関連項目

MCI

MCI コマンド