IPinConnection::DynamicQueryAccept
| Microsoft DirectShow 9.0 |
IPinConnection::DynamicQueryAccept
The DynamicQueryAccept method queries whether the pin can accept the specified media type while the graph is running with the current connection to this pin.
Syntax
HRESULT DynamicQueryAccept( const AM_MEDIA_TYPE *pmt );
Parameters
pmt
[in] Pointer to an AM_MEDIA_TYPE structure that specifies the media type.
Return Value
Returns an HRESULT value. Possible values include the following.
| Value | Description |
| S_OK | Media type is acceptable. |
| VFW_E_TYPE_NOT_ACCEPTED | Media type is not acceptable. |
Remarks
If this method succeeds, the pin can accept the media type on the next sample or in a call to IPin::ReceiveConnection.
An application or filter can call this method to determine whether the filter graph must be reconfigured. If the pin can accept the specified media type, there is no need to reconfigure the graph.
Although the IPin::QueryAccept method also determines whether a pin can accept a format type, it does not guarantee that the pin can switch to that format while the filter is running. If you need to switch formats while the filter is running, call DynamicQueryAccept instead.
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also