MCI_GETDEVCAPS コマンド

  • [アーティクル]

MCI_GETDEVCAPS コマンドは、デバイスに関する静的な情報を取得します。 すべてのデバイスでこのコマンドが認識されます。 このコマンドで使用できるパラメーターとフラグは、選択したデバイスによって異なります。 lpCapsParms によって識別される構造体の dwReturn メンバーに情報が返されます。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_GETDEVCAPS, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GETDEVCAPS_PARMS) lpCapsParms
);

パラメーター

wDeviceID

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

dwFlags

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

lpCapsParms

MCI_GETDEVCAPS_PARMS構造体へのポインター。

戻り値

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

解説

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

MCI_GETDEVCAPS_COMPOUND_DEVICE

デバイスが明示的に開いて閉じる必要があるデータ ストレージを使用する場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定されます。

MCI_GETDEVCAPS_DEVICE_TYPE

dwReturn メンバーは、「MCI デバイスの種類」に記載されている値のいずれかに設定されます。

MCI_GETDEVCAPS_HAS_AUDIO

デバイスにオーディオ出力がある場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定されます。

MCI_GETDEVCAPS_HAS_VIDEO

デバイスにビデオ出力がある場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定されます。 たとえば、videodisc コマンド セットをサポートするデバイスのメンバーは TRUE に 設定されます。

MCI_GETDEVCAPS_ITEM

MCI_GETDEVCAPS_PARMS構造体の dwItem メンバーに、次のいずれかの定数が含まれていることを指定します。

MCI_GETDEVCAPS_CAN_EJECT

デバイスがメディアを取り出すことができる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_GETDEVCAPS_CAN_PLAY

デバイスがメディアを再生できる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。 デバイスで TRUE が指定されている場合、デバイスは MCI_PAUSE コマンドとMCI_STOP コマンド、および MCI_PLAY コマンドをサポートします。

MCI_GETDEVCAPS_CAN_RECORD

デバイスが記録をサポートしている場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。 デバイスで TRUE が指定されている場合、デバイスは MCI_PAUSE コマンドとMCI_STOP コマンドと MCI_RECORD コマンドをサポートします。

MCI_GETDEVCAPS_CAN_SAVE

デバイスがファイルを保存できる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_GETDEVCAPS_USES_FILES

デバイスにファイル名が必要な場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定されます。 複合デバイスのみがファイルを使用します。

digitalvideo デバイスの種類の MCI_GETDEVCAPS_PARMS の dwItem メンバーには、次のフラグを指定できます。

MCI_DGV_GETDEVCAPS_CAN_FREEZE

デバイスがフレームを固定できる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_DGV_GETDEVCAPS_CAN_LOCK

デバイスがロックできる場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は FALSE に設定 されます。

MCI_DGV_GETDEVCAPS_CAN_REVERSE

デバイスが逆に再生できる場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は FALSE に設定 されます。

MCI_DGV_GETDEVCAPS_CAN_STR_IN

デバイスが入力をストレッチできる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_DGV_GETDEVCAPS_CAN_STRETCH

デバイスがイメージをストレッチできる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_DGV_GETDEVCAPS_CAN_TEST

デバイスがテストを実行できる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_DGV_GETDEVCAPS_HAS_STILL

デバイスが静止画像を表示できる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_DGV_GETDEVCAPS_MAX_WINDOWS

dwReturn メンバーは、デバイスが同時に処理できるウィンドウの最大数に設定されます。

MCI_DGV_GETDEVCAPS_MAXIMUM_RATE

dwReturn メンバーは、デバイスの最大再生速度 (1 秒あたりのフレーム数) に設定されます。

MCI_DGV_GETDEVCAPS_MINIMUM_RATE

dwReturn メンバーは、デバイスの最小再生速度 (1 秒あたりのフレーム数) に設定されます。

MCI_DGV_GETDEVCAPS_PALETTES

デバイスがパレット ハンドルを返すことができる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

vcr デバイスの種類の MCI_GETDEVCAPS_PARMS の dwItem メンバーには、次のフラグを指定できます。

MCI_GETDEVCAPS_CLOCK_INCREMENT_RATE

dwReturn メンバーは、1 秒あたりの増分数に設定されます。

MCI_VCR_GETDEVCAPS_CAN_DETECT_LENGTH

デバイスがメディアの長さを検出できる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_VCR_GETDEVCAPS_CAN_FREEZE

デバイスが出力イメージをフリーズできる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_VCR_GETDEVCAPS_CAN_MONITOR_SOURCES

デバイスがソースを監視できる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_VCR_GETDEVCAPS_CAN_PREROLL

デバイスがプリロールできる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_VCR_GETDEVCAPS_CAN_PREVIEW

デバイスがプレビュー可能な場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_VCR_GETDEVCAPS_CAN_REVERSE

デバイスが逆方向に再生できる場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は FALSE に設定 されます。

MCI_VCR_GETDEVCAPS_CAN_TEST

デバイスがテストできる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_VCR_GETDEVCAPS_HAS_CLOCK

デバイスが外部クロックをサポートしている場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_VCR_GETDEVCAPS_HAS_TIMECODE

デバイスにタイムコード機能がある場合、またはこの機能が不明な場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_VCR_GETDEVCAPS_NUMBER_OF_MARKS

dwReturn メンバーは、マークの数 (99) に設定されます。

MCI_VCR_GETDEVCAPS_SEEK_ACCURACY

dwReturn メンバーは、デバイスのシーク精度に設定されます。

オーバーレイ デバイスの種類のMCI_GETDEVCAPS_PARMSの dwItem メンバーには、次のフラグを指定できます。

MCI_OVLY_GETDEVCAPS_CAN_FREEZE

デバイスがイメージをフリーズできる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_OVLY_GETDEVCAPS_CAN_STRETCH

デバイスがイメージを拡大してフレームを埋めることができる場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定 されます。

MCI_OVLY_GETDEVCAPS_MAX_WINDOWS

dwReturn メンバーは、デバイスが同時に処理できるウィンドウの最大数に設定されます。

videodisc デバイスの種類の MCI_GETDEVCAPS_PARMS の dwItem メンバーには、次のフラグを指定できます。

MCI_VD_GETDEVCAPS_CAN_REVERSE

videodisc プレーヤーが逆再生できる場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は、FALSE に設定 されます。 一部のプレーヤーは、CLV ディスクと CAV ディスクを逆に再生できます。

MCI_VD_GETDEVCAPS_CAV

他の項目と組み合わせると、戻り値の情報が CAV 形式の videodiscs に適用されることを指定します。 videodisc が挿入されない場合は、これが既定値です。

MCI_VD_GETDEVCAPS_CLV

他の項目と組み合わせると、戻り値の情報が CLV 形式の videodiscs に適用されることを指定します。

MCI_VD_GETDEVCAPS_FAST_RATE

dwReturn メンバーは、1 秒あたりのフレーム数で標準の高速再生レートに設定されます。

MCI_VD_GETDEVCAPS_NORMAL_RATE

dwReturn メンバーは、1 秒あたりのフレーム数で通常の再生レートに設定されます。

MCI_VD_GETDEVCAPS_SLOW_RATE

dwReturn メンバーは、1 秒あたりのフレーム数で標準の低速再生速度に設定されます。

waveaudio デバイスの種類の MCI_GETDEVCAPS_PARMS の dwItem メンバーには、次のフラグを指定できます。

MCI_WAVE_GETDEVCAPS_INPUT

dwReturn メンバーは、波形入力 (記録) デバイスの合計数に設定されます。

MCI_WAVE_GETDEVCAPS_OUTPUT

dwReturn メンバーは、波形出力 (再生) デバイスの合計数に設定されます。

必要条件

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

関連項目

Mci

MCI コマンド