IMFTransform::ProcessMessage method

Sends a message to the Media Foundation transform (MFT).

Syntax

HRESULT ProcessMessage(
  MFT_MESSAGE_TYPE eMessage,
  ULONG_PTR        ulParam
);

Parameters

eMessage

The message to send, specified as a member of the MFT_MESSAGE_TYPE enumeration.

ulParam

Message parameter. The meaning of this parameter depends on the message type.

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 number. Applies to the MFT_MESSAGE_NOTIFY_END_OF_STREAM message.
MF_E_TRANSFORM_TYPE_NOT_SET
The media type is not set on one or more streams.

Remarks

Before calling this method, set the media types on all input and output streams.

The MFT might ignore certain message types. If so, the method returns S_OK. An error code indicates that the transform handles this message type but was unable to process the message in this instance.

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

Requirements

   
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

See Also

IMFTransform

Media Foundation Transforms