CBasePin::AgreeMediaType (Compact 2013)

3/26/2014

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

Header

dshow.h,
Streams.h

Library

ole32.lib,
Ole32auth.lib,
Strmbase.lib,
Strmiids.lib,
uuid.lib

See Also

Reference

CBasePin Class