Microsoft DirectX 9.0


The ConnectionMediaType method retrieves the media type for the current pin connection, if any.


HRESULT ConnectionMediaType(



[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.


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.

See Also