IAMExtDevice::GetCapability
GetCapability メソッドは、外部デバイスの機能を取得する。
構文
HRESULT GetCapability(
long Capability,
long *pValue,
double *pdblValue
);
パラメータ
Capability
[in] 調べる機能を指定する。詳細については、「注意」を参照すること。
pValue
[out] long 型の整数値を受け取る変数へのポインタ。詳細については、「注意」を参照すること。
pdblValue
[out] double 型の値を受け取る変数へのポインタ。詳細については、「注意」を参照すること。
戻り値
メソッドが成功すると、戻り値は S_OK となる。それ以外の場合は HRESULT エラー コードを返す。
注意
Capability 引数は、調べる機能を指定するフラグである。このメソッドは、機能フラグに応じて、pValue 引数または pdblValue 引数に結果を返す。
以下のフラグについて、このメソッドは、pValue 引数に値 OATRUE または OAFALSE を返す。値 OATRUE は、機能が存在することを示し、値 OAFALSE は、機能が存在しないことを示す。
| 機能フラグ | 説明 |
| ED_DEVCAP_AUDIO_INPUTS | このデバイスは、オーディオ入力を受け付ける。 |
| ED_DEVCAP_CAN_MONITOR_SOURCES | デバイスは、現在選択されている入力に関係なく、あらゆる入力を、監視対象の出力に送信できる。 |
| ED_DEVCAP_CAN_PREVIEW | デバイスはプレビュー可能である。 |
| ED_DEVCAP_CAN_RECORD | デバイスは録音/録画可能である。 |
| ED_DEVCAP_CAN_RECORD_STROBE | デバイスは録音/録画をストロボできる。この機能は、特定のトラックに録音/録画可能なマルチトラック デバイスに適用される。 |
| ED_DEVCAP_CAN_SAVE | このデバイスは、データを保存できる。 |
| ED_DEVCAP_CTLTRK_READ | このデバイスは、制御トラックを読み取ることができる。 |
| ED_DEVCAP_HAS_AUDIO | このデバイスにはオーディオがある。 |
| ED_DEVCAP_HAS_VIDEO | このデバイスにはビデオがある。 |
| ED_DEVCAP_INDEX_READ | このデバイスは、インデックス マークを読み取れる。 |
| ED_DEVCAP_NEEDS_CALIBRATING | このデバイスにはキャリブレーションが必要である。「IAMExtDevice::Calibrate」を参照すること |
| ED_DEVCAP_TIMECODE_READ | このデバイスは、SMPTE タイムコードを読み取れる。 |
| ED_DEVCAP_TIMECODE_WRITE | このデバイスは、SMPTE タイムコードを設定できる。 |
| ED_DEVCAP_USES_FILES | デバイスにファイル システムが組み込まれている。 |
| ED_DEVCAP_VIDEO_INPUTS | このデバイスは、ビデオ入力を受け付ける。 |
以下のフラグについて、このメソッドは、定義された定数を pValue 引数に返す。
- ED_DEVCAP_DEVICE_TYPE: デバイス タイプを返す。
| 返される定数 | 説明 |
| ED_DEVTYPE_ATR | オーディオ テープ レコーダ |
| ED_DEVTYPE_CG | キャラクタ ジェネレータ |
| ED_DEVTYPE_DDR | デジタル ディスク レコーダ |
| ED_DEVTYPE_DVE | デジタル ビデオ エフェクト ユニット |
| ED_DEVTYPE_GPI | 汎用インターフェイス トリガ |
| ED_DEVTYPE_KEYER | ビデオ キーヤー |
| ED_DEVTYPE_LASERDISK | レーザーディスク |
| ED_DEVTYPE_MIXER_AUDIO | オーディオ ミキサー |
| ED_DEVTYPE_MIXER_VIDEO | ビデオ ミキサー |
| ED_DEVTYPE_ROUTER | ビデオ ルーター |
| ED_DEVTYPE_TBC | タイムベース コレクタ |
| ED_DEVTYPE_TCG | タイムコード ジェネレータ/リーダー |
| ED_DEVTYPE_VCR | VCR、または VCR の全機能を持つカムコーダ |
| ED_DEVTYPE_WIPEGEN | ビデオ ワイプ ジェネレータ |
| ED_DEVTYPE_JOYSTICK | ジョイスティック |
| ED_DEVTYPE_KEYBOARD | キーボード |
- ED_DEVCAP_SYNC_ACCURACY: デバイスの同期精度を示す。
| 返される定数 | 説明 |
| ED_SYNCACC_PRECISE | デバイスの精度は高い。 |
| ED_SYNCACC_FRAME | デバイスはフレーム単位の精度を持つ。 |
| ED_SYNCACC_ROUGH | デバイスはフレーム単位以下の精度しか持たない。 |
- ED_DEVCAP_NORMAL_RATE: デバイスの標準フレーム レートを返す。
| 返される定数 | 説明 |
| ED_RATE_24 | 24 フレーム/秒 (fps)。 |
| ED_RATE_25 | 25 fps |
| ED_RATE_2997 | 29.997 fps |
| ED_RATE_30 | 30 fps |
- ED_DEVCAP_SEEK_TYPE: デバイスのシーク精度を示す。
| 返される定数 | 説明 |
| ED_SEEK_PERFECT | このデバイスは、信号の不連続を生じさせずに、1 つのビデオ フレーム内でシークできる。 |
| ED_SEEK_FAST | このデバイスは、信号に短い不連続を生じさせて、すばやくシークできる。 |
| ED_SEEK_SLOW | デバイスのシーク速度は遅い。テープ駆動デバイスなど。 |
以下のフラグについて、このメソッドは、数値を pValue 引数に返す。
| 機能フラグ | 戻り値 |
| ED_DEVCAP_EXTERNAL_DEVICE_ID | メーカー固有の ID。 |
| ED_DEVCAP_PREROLL | デバイスのプリロール タイム。 |
| ED_DEVCAP_POSTROLL | デバイスのポストロール タイム。 |
DV の実装
MSDV は、以下の動作をサポートする。
- ED_DEVCAP_DEVICE_TYPE フラグは、デバイス タイプを返す。
| 返される定数 | 説明 |
| ED_DEVTYPE_CAMERA | 録画と録画ポーズ機能はあるが、VCR の全機能は備えていない単純なカメラ。 |
| ED_DEVTYPE_DVHS | このデバイスは、D-VHS フォーマットをサポートしている。 |
| ED_DEVTYPE_UNKNOWN | 不明なデバイス タイプ。 |
| ED_DEVTYPE_VCR | このデバイスは、VCR の全機能を備えている。 |
- ED_DEVCAP_NORMAL_RATE フラグは、カムコーダのフレーム レートを返す。
| 返される定数 | 説明 |
| ED_RATE_25 | 25 fps (既定の NTSC フレーム レート) |
| ED_RATE_2997 | 29.997 fps (既定の PAL フレーム レート) |
参照