IPin::QueryAccept メソッド (strmif.h)

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

メソッドは QueryAccept 、ピンが指定されたメディアの種類を受け入れるかどうかを判断します。

構文

HRESULT QueryAccept(
  [in] const AM_MEDIA_TYPE *pmt
);

パラメーター

[in] pmt

メディアの種類を指定する AM_MEDIA_TYPE 構造体へのポインター。

戻り値

次の値のいずれか。

リターン コード	説明
S_FALSE	ピンはメディアの種類を拒否します。
S_OK	ピンはメディアの種類を受け入れます。

注釈

S_OK の戻り値は、次のサンプルで、またはピンの再接続後に、ピンがメディアの種類を受け入れることを示します。 実装では、他のピンの接続や、フィルターで設定できるプロパティなど、フィルターの現在の状態を考慮する必要があります。

S_FALSEを含む他の戻り値は、ピンがメディアの種類を拒否することを意味します。 したがって、S_OKを明示的にテストします。 SUCCEEDED マクロは使用しないでください。

フィルターが実行されている場合、S_OKの戻り値はあいまいです。 ピンは、再接続せずに、次のメディア サンプルの形式変更を受け入れる場合があります。または、再接続が必要な場合があります。 ピンが IPinConnection インターフェイスをサポートしている場合は、 IPinConnection::D ynamicQueryAccept メソッドを呼び出します。このメソッドは、ピンが再接続せずに新しい型を受け入れられるかどうかを具体的にテストします。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	strmif.h (Dshow.h を含む)
Library	Strmiids.lib

こちらもご覧ください

フィルター グラフのData Flow

動的書式の変更

エラーコードと成功コード

IPin インターフェイス