Microsoft Windows CE 3.0  

CBasePin::AgreeMediaType

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.

This member function is called during the connection process to enumerates the preferred data types between owning pin and the receiving pin of a connection.

virtual HRESULT AgreeMediaType(
IPin *
pReceivePin, 
const CMediaType
*
pmt
);

Parameters

pReceivePin
Pointer to the receiving pin.
pmt
Pointer to a media type object to be returned.

Return Values

Returns an HRESULTvalue, which can include one of the following values.

NOERROR A media type was found.
VFW_E_NO_ACCEPTABLE_TYPES No agreement on a media type was reached.

Remarks

This member function is called during the connection process. It calls CBasePin::TryMediaTypeson both the owning pin and the pin connected to the owning pin; it enumerates the preferred data types on the pin. If one is found, TryMediaTypestries the media type with the pin in a call to the CBasePin::ReceiveConnectionmember function. If this pin proposes a media type, its support is still verified by calling CBasePin::CheckMediaType. The enumerator can list all the media types, even if some of them are not currently available.

This member function is protected.