 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
Determines a media type for a pin connection.
virtual HRESULT TryMediaTypes( IPin * pReceivePin , const CMediaType * pmt , IEnumMediaTypes * pEnum );
Parameters
- pReceivePin
- Pointer to the IPininterface of the receiving pin.
- pmt
- Pointer to a returned media type.
- pEnum
- Pointer to an
IEnumMediaTypesenumerator interface.
Return Values
Returns an HRESULTvalue, which can include the following.
FAILED Resetting of the enumerator failed. NOERROR Media type found. VFW_E_NO_ACCEPTABLE_TYPES No acceptable media types were found. Remarks
Given an enumerator, this member function cycles through all the media types proposed by the enumerator. Each type is suggested to the derived pin class and, if acceptable, is tried with the connected pin in a call to the IPin::ReceiveConnectionmethod. This means that if the owning pin proposes a media type, it is still checked to determine whether it is supported. This is deliberate so that, in simple cases, the enumerator can hold all the media types, even if some of them are not currently available.
This member function is protected.