CBasePin::AgreeMediaType
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 HRESULT value, which can include one of the following values.
Value | Description |
---|---|
NOERROR |
A media type was found. |
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 |