IMediaObject::AllocateStreamingResources (Compact 2013)

3/26/2014

This method allocates any resources needed by the DMO. Calling this method is always optional. Do not call this method unless you have a specific reason to do so.

Syntax

HRESULT AllocateStreamingResources(void);

Return Value

Returns S_OK if successful. Otherwise, returns an HRESULT value indicating the cause of the error.

Remarks

An application can call this method as a streaming optimization. It gives the DMO an opportunity to perform any time-consuming initializations before streaming begins.

If you call this method, do so after you set the media types on the DMO, but before you make the first calls to IMediaObject::ProcessInput or IMediaObject::ProcessOutput.

This method is optional in the following sense:

• If the DMO does not support this method, the method returns S_OK.
• If the application never calls this method, the DMO allocates resources within a call to ProcessInput or ProcessOutput.

If the DMO supports this method, it should also support the IMediaObject::FreeStreamingResources method.

Requirements

See Also

Reference

IMediaObject
IMediaObject::ProcessOutput
IMediaObject::ProcessInput
IMediaObject::FreeStreamingResources