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
Header |
dmo.h |
Library |
Dmoguid.lib |
See Also
Reference
IMediaObject
IMediaObject::ProcessOutput
IMediaObject::ProcessInput
IMediaObject::FreeStreamingResources