IPinConnection::DynamicQueryAccept
DynamicQueryAccept メソッドは、現在このピンに接続しているグラフの実行中に、指定されたメディア タイプをピンが受け付けることができるかどうかを問い合わせる。
構文
HRESULT DynamicQueryAccept(
const AM_MEDIA_TYPE *pmt
);
パラメータ
pmt
[in] メディア タイプを指定する AM_MEDIA_TYPE 構造体へのポインタ。
戻り値
HRESULT 値を返す。可能な値は次のとおりである。
値 | 説明 |
S_OK | メディア タイプは使用可能である。 |
VFW_E_TYPE_NOT_ACCEPTED | メディア タイプは使えない。 |
注意
このメソッドが成功した場合、ピンは、次のサンプル上のメディア タイプ、または IPin::ReceiveConnection の呼び出しで指定されるメディア タイプを受け付けることができる。
アプリケーションまたはフィルタでは、このメソッドを呼び出して、フィルタ グラフを再構成する必要があるかどうかを判断できる。指定したメディア タイプをピンが受け付けることができる場合、グラフを再構成する必要はない。
IPin::QueryAccept メソッドは、ピンがフォーマット タイプを受け付けることができるかどうかも判断する。ただし、フォーマット タイプが受け付けられても、フィルタ実行中にピンがそのフォーマットに切り替わることができるとは限らない。フィルタ実行中にフォーマットを切り替える必要がある場合は、代わりに DynamicQueryAccept を呼び出す。
参照