IAMExtTransport::GetCapability メソッド (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
メソッドは GetCapability 、トランスポートの一般的な機能を取得します。
構文
HRESULT GetCapability(
[in] long Capability,
[out] long *pValue,
[out] double *pdblValue
);
パラメーター
[in] Capability
チェックする機能を指定します。 詳細については、「解説」を参照してください。
[out] pValue
長整数を受け取る変数へのポインター。 詳細については、「解説」を参照してください。
[out] pdblValue
double を受け取る変数へのポインター。 詳細については、「解説」を参照してください。
戻り値
このメソッドが成功すると、S_OKが返されます。 それ以外の場合は、 HRESULT エラー コードが返されます。
注釈
Capability パラメーターは、チェックする機能を指定するフラグです。 メソッドは、機能フラグに応じて、 pValue パラメーターまたは pdblValue パラメーターのいずれかで結果を返します。
次のフラグの場合、メソッドは pValue パラメーターで値 OATRUE または OAFALSE を返します。 値 OATRUE は機能が存在することを示し、値 OAFALSE は存在しない場合を示します。
| 機能フラグ | 説明 |
|---|---|
| ED_TRANSCAP_CAN_ASSEMBLE | トランスポートでは、アセンブル レコード モードを使用できます (以前に記録したセグメントからコントロール トラックにシームレスにリンクする新しいトラックを記録します)。 |
| ED_TRANSCAP_CAN_BUMP_PLAY | トランスポートは、さまざまな速度で同期できます。 |
| ED_TRANSCAP_CAN_DELAY_AUDIO_IN | トランスポートでは、遅延オーディオ編集を実行できます。 |
| ED_TRANSCAP_CAN_DELAY_AUDIO_OUT | トランスポートは、遅延した音声編集を実行できます。 |
| ED_TRANSCAP_CAN_DELAY_VIDEO_IN | トランスポートでは、遅延したビデオ編集を実行できます。 |
| ED_TRANSCAP_CAN_DELAY_VIDEO_OUT | トランスポートでは、遅延したビデオ編集を実行できます。 |
| ED_TRANSCAP_CAN_DETECT_LENGTH | トランスポートは、メディアの長さを検出できます。 |
| ED_TRANSCAP_CAN_EJECT | トランスポートはメディアを取り出すことができます。 |
| ED_TRANSCAP_CAN_FREEZE | トランスポートはフリーズ/一時停止できます。 |
| ED_TRANSCAP_CAN_INSERT | トランスポートでは、レコードの挿入モードを使用できます (事前に記録されたコントロール トラックにロックされている間、個々のトラックを記録します)。 |
| ED_TRANSCAP_CAN_PLAY_BACKWARDS | トランスポートは後方に再生できます。 |
| ED_TRANSCAP_CAN_SET_EE | トランスポートは、デバイスの入力を出力に表示できます。 |
| ED_TRANSCAP_CAN_SET_PB | トランスポートでは、出力にメディアの再生を表示できます。 |
| ED_TRANSCAP_FIELD_STEP | トランスポートは、1 つのフィールドを進めることで、フレームの事前コマンドに応答します。 |
| ED_TRANSCAP_HAS_CLOCK | デバイスにはクロックがあります。 |
| ED_TRANSCAP_HAS_DT | デバイスには動的追跡があります。 |
| ED_TRANSCAP_HAS_TIMER | デバイスにタイマーがあります。 |
| ED_TRANSCAP_HAS_TUNER | デバイスにチューナがあります。 |
| ED_TRANSCAP_IS_MASTER | デバイスは同期用のマスター クロックです。 |
| ED_TRANSCAP_MULTIPLE_EDITS | デバイスでは、複数の編集イベントがサポートされています。 |
| ED_TRANSCAP_NEEDS_CUEING | 編集を実行する前に、デバイスを選択する必要があります。 |
| ED_TRANSCAP_NEEDS_TBC | デバイスを調整する必要があります。 |
次のフラグの場合、 メソッドは pValue パラメーターに数値を返します。
| 機能フラグ | 戻り値 |
| ED_TRANSCAP_LTC_TRACK | LTC タイムコード トラックのトラック番号を返します。専用のタイムコード トラックがない場合はED_ALL。 |
| ED_TRANSCAP_NUM_AUDIO_TRACKS | オーディオ トラックの数を返します。 |
次のフラグの場合、 メソッドは pdblValue パラメーターの値を返します。
| 機能フラグ | 戻り値 |
| ED_TRANSCAP_FWD_SHUTTLE_MAX | 再生速度の倍数として、シャトルモードでの最大前方速度。 |
| ED_TRANSCAP_FWD_SHUTTLE_MIN | 再生速度の倍数として、シャトルモードの最小前方速度。 |
| ED_TRANSCAP_FWD_VARIABLE_MAX | 再生速度の倍数として、最大前方速度。 |
| ED_TRANSCAP_FWD_VARIABLE_MIN | 再生速度の倍数として、最小前方速度。 |
| ED_TRANSCAP_REV_SHUTTLE_MAX | 再生速度の倍数として、シャトルモードでの最大逆速度。 |
| ED_TRANSCAP_REV_SHUTTLE_MIN | 再生速度の倍数として、シャトルモードでの最小逆速度。 |
| ED_TRANSCAP_REV_VARIABLE_MAX | 再生速度の倍数として、最大逆速度。 |
| ED_TRANSCAP_REV_VARIABLE_MIN | 再生速度の倍数として、最小逆速度。 |
DV の実装
MSDV では、このメソッドはサポートされていません。 E_NOTIMPLを返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | strmif.h (Dshow.h を含む) |
| Library | Strmiids.lib |