Partager via


CBasePin::ConnectionMediaType

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This member function returns information about the negotiated media type for the pin connection.

Syntax

HRESULT ConnectionMediaType(
  AM_MEDIA_TYPE* pmt
);

Parameters

  • pmt
    Pointer to an AM_MEDIA_TYPE structure.

    If the pin is not connected, this structure is initialized to zero; otherwise, the media type is returned in this parameter.

Return Value

Returns an HRESULT value.

Remarks

This member function implements the IPin::ConnectionMediaType method.

It returns a copy of the AM_MEDIA_TYPE structure that was negotiated for the pin connection when the pin was connected.

This method fails if the pin is unconnected.

The task allocator allocates the media type's format block. Use the task allocator to free the format block, for example by calling the Win32 CoTaskMemFree function.

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