IMediaObject::AllocateStreamingResources

  • Article

This method allocates any resources needed by the DMO. Calling this method is always optional.

HRESULT AllocateStreamingResources(void);

Return Values

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

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

See Also

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

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.