DynamicQueryAccept
Collapse the table of content
Expand the table of content

IPinConnection::DynamicQueryAccept method

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(
  [inconst 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.

Return codeDescription
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

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Strmif.h (include Dshow.h)

Library

Strmiids.lib

See also

Dynamic Format Changes
Error and Success Codes
IPinConnection Interface

 

 

Show:
© 2016 Microsoft