IMFDeviceTransform::GetInputCurrentType method (mftransform.h)

2024-02-22

The GetInputCurrentType method gets the current media type for an input stream on this Media Foundation transform (MFT).

Syntax

HRESULT GetInputCurrentType(
  [in]  DWORD        dwInputStreamID,
  [out] IMFMediaType **pMediaType
);

Parameters

[in] dwInputStreamID

Input stream identifier. To get the list of stream identifiers, call IMFDeviceTransform::GetStreamIDs.

[out] pMediaType

Receives a pointer to the IMFMediaType interface that represents the current type used by that stream.

Return value

The method returns an HRESULT. Possible values include but not limited to values given in the following table.

Return code	Description
S_OK	Initialization succeeded
MF_E_INVALIDREQUEST	Device MFT could not support the request at this time.
MF_E_INVALIDSTREAMNUMBER	The stream ID is not valid.
MF_E_NO_MORE_TYPES	There is no media type available with the specified index.
MF_E_TRANSFORM_TYPE_NOT_SET	No media type has been set yet.

Remarks

If the specified input stream does not yet have a media type, the method returns MF_E_TRANSFORM_TYPE_NOT_SET.

Implementation notes

The MFT should return a clone of the media type, not a pointer to the original type. Otherwise, the caller might modify the type and alter the internal state of the MFT.

Requirements

Requirement	Value
Minimum supported client	Windows 10, version 1703
Target Platform	Windows
Header	mftransform.h

Share via