IAMStreamConfig::GetNumberOfCapabilities メソッド (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
メソッドは GetNumberOfCapabilities 、このピンでサポートされている書式機能の数を取得します。
構文
HRESULT GetNumberOfCapabilities(
[out] int *piCount,
[out] int *piSize
);
パラメーター
[out] piCount
書式機能の数を受け取る変数へのポインター。
[out] piSize
構成構造体のサイズをバイト単位で受け取る変数へのポインター。 詳細については、「解説」を参照してください。
戻り値
HRESULT 値を返します。 使用可能な値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
成功しました。 |
|
NULL ポインター値。 |
|
入力ピンが接続されていません。 |
解説
出力ピンは、複数のフォーマット機能セットをサポートできます。 このメソッドは、ピンでサポートされている機能の合計数を返します。数値は piCount パラメーターで返されます。 特定の機能セットを取得するには、 IAMStreamConfig::GetStreamCaps メソッドを 呼び出します。 書式機能は 0 からインデックスが作成されるため、 piCount で返される値は上限よりも 1 つ多くなります。
ピンの形式の種類、 VIDEO_STREAM_CONFIG_CAPS 構造 (ビデオの場合) または AUDIO_STREAM_CONFIG_CAPS 構造 (オーディオの場合) に応じて異なります。 piSize パラメーターは、構造体のサイズをバイト単位で受け取ります。
一部の圧縮フィルターでは、フィルターの入力ピンが接続されていない場合、このメソッドは失敗します。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | strmif.h (Dshow.h を含む) |
| Library | Strmiids.lib |