Export (0) Print
Expand All

IMFTransform::GetOutputCurrentType method

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

dwOutputStreamID [in]

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

ppType [out]

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 codeDescription
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

Minimum supported client

Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 [desktop apps | Windows Store apps]

Header

Mftransform.h

Library

Mfuuid.lib

See also

IMFTransform
Media Foundation Transforms

 

 

Community Additions

ADD
Show:
© 2014 Microsoft