Microsoft DirectX 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.

See Also