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.
A version of this page is also available for
4/8/2010

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.

Syntax 

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 Value

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

Value Description

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, and it enumerates the preferred data type on the pin.

If a preferred data type 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 verified by calling CBasePin::CheckMediaType.

The enumerator can list all media types, even if some are not currently available.

This member function is protected.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment,
Version 2.12 requires DXPAK 1.0 or later