IMFTransform::ProcessMessage Method

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

Syntax

public:
HRESULT ProcessMessage(
         MFT_MESSAGE_TYPE eMessage,
         ULONG_PTR ulParam
)

Parameters

eMessage
Type: MFT_MESSAGE_TYPE

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

ulParam
Type: ULONG_PTR

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

Return value

Type: HRESULT

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

Return codes

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.

Refer to Media Foundation return codes.

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

Header: Declared in mftransform.h.

Library: Use Mfuuid.lib.