Edit

Share via

IMFTransform::ProcessMessage method (mftransform.h)

  • Article

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

Syntax

HRESULT ProcessMessage(
  [in] MFT_MESSAGE_TYPE eMessage,
  [in] ULONG_PTR        ulParam
);

Parameters

[in] eMessage

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

[in] 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

Each message type has a different requirement for calling order, see the MFT_MESSAGE_TYPE enumeration for more details.

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

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

See also

IMFTransform

Media Foundation Transforms