次の方法で共有

IAMStreamConfig::GetNumberOfCapabilities

  • [アーティクル]

GetNumberOfCapabilities メソッドは、このピンがサポートするフォーマット機能の数を取得する。

構文

  HRESULT GetNumberOfCapabilities(
  int *piCount,
  int *piSize
);

パラメータ

piCount

[out] フォーマット機能の数を受け取る変数へのポインタ。

piSize

[out] 構成構造体のサイズ (バイト単位) を受け取る変数へのポインタ。詳細については、「注意」を参照すること。

戻り値

HRESULT 値を返す。可能な値は次のとおりである。

戻りコード 説明
S_OK 成功。
E_POINTER NULL ポインタ値。
VFW_E_NOT_CONNECTED 入力ピンが接続されていない。

注意

出力ピンは、複数のフォーマット機能セットをサポートできる。このメソッドは、ピンがサポートする機能の合計数を piCount 引数内に返す。特定の機能セットを取得するには、IAMStreamConfig::GetStreamCaps メソッドを呼び出す。フォーマット機能はゼロからインデックスされるため、piCount に返される値は、上限より 1 つ大きくなる。

ピンのフォーマット タイプに応じて、GetStreamCaps メソッドは、VIDEO_STREAM_CONFIG_CAPS 構造体 (ビデオの場合) または AUDIO_STREAM_CONFIG_CAPS 構造体 (オーディオの場合) を返す。piSize 引数は、構造体のサイズをバイトで受け取る。

いくつかの圧縮フィルタでは、フィルタの入力ピンが接続されていない場合、このメソッドは失敗する。

参照