Share via


IMediaObject::ProcessOutput (Windows CE 5.0)

Send Feedback

This method generates output from the current input data.

HRESULT ProcessOutput(DWORDdwFlags,DWORDcOutputBufferCount,DMO_OUTPUT_DATA_BUFFER* pOutputBuffers,DWORD* pdwStatus);

Parameters

  • dwFlags
    Bitwise combination of zero or more flags from the DMO_PROCESS_OUTPUT_FLAGS enumeration.
  • cOutputBufferCount
    Number of output buffers.
  • pOutputBuffers
    [in, out] Pointer to an array of DMO_OUTPUT_DATA_BUFFER structures containing the output buffers. Specify the size of the array in the cOutputBufferCount parameter.
  • pdwStatus
    [out] Pointer to a variable that receives a reserved value (zero). The application should ignore this value.

Return Values

Returns an HRESULT value. Possible values include the following.

Value Description
S_OK Success
S_FALSE No output to process
E_FAIL Failure
E_INVALIDARG Invalid argument
E_POINTER NULL pointer argument

Remarks

The pOutputBuffers parameter points to an array of DMO_OUTPUT_DATA_BUFFER structures. The application must allocate one structure for each output stream. To determine the number of output streams, call the IMediaObject::GetStreamCount method. Set the cOutputBufferCount parameter to this number.

Each DMO_OUTPUT_DATA_BUFFER structure contains a pointer to a buffer's IMediaBuffer interface. The application allocates these buffers. The other members of the structure are status fields. The DMO sets these fields if the method succeeds. If the method fails, their values are undefined.

When the application calls ProcessOutput, the DMO processes as much input data as possible. It writes the output data to the output buffers, starting from the end of the data in each buffer. To find the end of the data, call the IMediaBuffer::GetBufferAndLength method. The DMO never holds a reference count on an output buffer.

If the DMO fills an entire output buffer and still has input data to process, the DMO returns the DMO_OUTPUT_DATA_BUFFERF_INCOMPLETE flag in the DMO_OUTPUT_DATA_BUFFER structure. The application should check for this flag by testing the dwStatus member of each structure.

If the method returns S_FALSE, no output was generated. However, a DMO is not required to return S_FALSE in this situation; it might return S_OK.

You can discard data from a stream by setting the DMO_PROCESS_OUTPUT_DISCARD_WHEN_NO_BUFFER flag in the dwFlags parameter. For each stream that you want to discard, set the pBuffer member of the DMO_OUTPUT_DATA_BUFFER structure to NULL.

For each stream in which pBuffer is NULL:

  • If the DMO_PROCESS_OUTPUT_DISCARD_WHEN_NO_BUFFER flag is set, and the stream is discardable or optional, the DMO discards the data.
  • If the flag is set but the stream is neither discardable nor optional, the DMO discards the data if possible. It is not guaranteed to discard the data.
  • If the flag is not set, the DMO does not produce output data for that stream and does not discard the data.

To check whether a stream is discardable or optional, call the IMediaObject::GetOutputStreamInfo method.

Requirements

OS Versions: Windows CE .NET 4.1 and later.
Header: Dmo.h.
Link Library: Dmoguid.lib.

See Also

IMediaObject | IMediaObject::GetStreamCount | IMediaObject::GetOutputStreamInfo | IMediaBuffer | IMediaBuffer::GetBufferAndLength | DMO_OUTPUT_DATA_BUFFER | DMO_OUTPUT_DATA_BUFFERF_INCOMPLETE | DMO_PROCESS_OUTPUT_FLAGS | DMO_E_INVALIDSTREAMINDEX

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.