IMFDeviceTransform::ProcessMessage method (mftransform.h)

  • Article

The ProcessMessage method sends a message to the Device 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 not limited to values given in the following table.

Return code Description
S_OK
 Method succeeded.
E_INVALIDARG
 Invalid argument passed.
MF_E_INVALIDREQUEST
 Device MFT could not support the request at this time.
MF_E_INVAILIDSTREAMNUMBER
 An invalid stream ID was passed.
MF_E_INVALID_STREAM_STATE
 The requested stream transition is not possible.
MF_E_TRANSFORM_TYPE_NOT_SET
 Input media type has not been set.

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.

For more information, see MFT_MESSAGE_TYPE.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1703
Target Platform Windows
Header mftransform.h

See also

IMFDeviceTransform