Share via


CBasePin::AgreeMediaType

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 HRESULT value, 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::TryMediaTypes on 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, TryMediaTypes tries the media type with the pin in a call to the CBasePin::ReceiveConnection member 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