IMFTransform::GetOutputCurrentType method (mftransform.h)

Article
02/22/2024

Gets the current media type for an output stream on this Media Foundation transform (MFT).

Syntax

HRESULT GetOutputCurrentType(
  [in]  DWORD        dwOutputStreamID,
  [out] IMFMediaType **ppType
);

Parameters

[in] dwOutputStreamID

Output stream identifier. To get the list of stream identifiers, call IMFTransform::GetStreamIDs.

[out] ppType

Receives a pointer to the IMFMediaType interface. The caller must release the interface.

Return value

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

Return code	Description
S_OK	The method succeeded.
MF_E_INVALIDSTREAMNUMBER	Invalid stream identifier.
MF_E_TRANSFORM_TYPE_NOT_SET	The output media type has not been set.

Remarks

If the specified output stream does not yet have a media type, the method returns MF_E_TRANSFORM_TYPE_NOT_SET. Most MFTs do not set any default media types when first created. Instead, the client must set the media type by calling IMFTransform::SetOutputType.

If MFT_UNIQUE_METHOD_NAMES is defined before including mftransform.h, this method is renamed MFTGetOutputCurrentType. See Creating Hybrid DMO/MFT Objects.

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 Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps \| UWP apps]
Target Platform	Windows
Header	mftransform.h
Library	Mfuuid.lib