IWMReaderAdvanced::SetAllocateForOutput method

The SetAllocateForOutput method specifies whether the reader allocates its own buffers for output samples or gets buffers from your application.

Syntax

HRESULT SetAllocateForOutput(
  DWORD dwOutputNum,
  BOOL  fAllocate
);

Parameters

dwOutputNum

DWORD containing the output number.

fAllocate

Boolean value that is True if the reader gets buffers from your application.

Return value

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Remarks

You can allocate your own buffers for file reading to reduce the overhead required by the reader object to allocate a new buffer for every sample. The reader object will make calls to the IWMReaderCallbackAdvanced::AllocateForOutput method.

If the application's callback implements the IWMReaderAllocatorEx interface, the AllocateForOutputEx method is called instead of AllocateForOutput.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only],Windows Media Format 7 SDK, or later versions of the SDK
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wmsdkidl.h (include Wmsdk.h)
Library Wmvcore.lib; WMStubDRM.lib (if you use DRM)

See also

IWMReaderAdvanced Interface

IWMReaderAdvanced::GetAllocateForOutput