Microsoft Windows CE 3.0  

CBasePin::ConnectionMediaType

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.

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

HRESULT ConnectionMediaType(
AM_MEDIA_TYPE *
pmt
);

Parameters

pmt
Pointer to an AM_MEDIA_TYPEstructure. If the pin isn't connected, this structure is initialized to zero. Otherwise, the media type is returned in this parameter.

Return Values

Returns an HRESULTvalue.

Remarks

This member function implements the IPin::ConnectionMediaTypemethod. It returns a copy of the AM_MEDIA_TYPEstructure 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 Microsoft Win32 CoTaskMemFreefunction.