Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
| Microsoft DirectShow 9.0 |
CBasePin::ConnectionMediaType
The ConnectionMediaType method retrieves the media type for the current pin connection, if any. This method implements the IPin::ConnectionMediaType method.
Syntax
HRESULT ConnectionMediaType(
AM_MEDIA_TYPE *pmt
);
Parameters
pmt
Pointer to an AM_MEDIA_TYPE structure that receives the media type.
Return Value
Returns an HRESULT value. Possible values include those in the following table.
| 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 zeroes the memory block specified by pmt and returns an error code.
Requirements
** Header:** Declared in Amfilter.h; include Streams.h.
** Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).
See Also