IPin::ConnectionMediaType
| Microsoft DirectShow 9.0 |
IPin::ConnectionMediaType
The ConnectionMediaType method retrieves the media type for the current pin connection, if any.
Syntax
HRESULT ConnectionMediaType( AM_MEDIA_TYPE *pmt );
Parameters
pmt
[out] Pointer to an AM_MEDIA_TYPE structure that receives the media type.
Return Value
Returns an HRESULT value. Possible values include the following.
| Value | Description |
| S_OK | Success. |
| E_POINTER | Null pointer argument. |
| VFW_E_NOT_CONNECTED | Pin is not connected. |
Remarks
If the pin is connected, this method copies the media type into the AM_MEDIA_TYPE structure specified by pmt. The caller must free the media type's format block. You can use the Microsoft® Win32® CoTaskMemFree function, or the FreeMediaType helper function.
If the pin is not connected, this method clears the media type specified by pmt and returns an error code.
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also