Share via

IMSVidVideoRenderer2::_SetAllocator

  • Article
 
Microsoft DirectShow 9.0

IMSVidVideoRenderer2::_SetAllocator

This topic applies to Windows XP Service Pack 1 or later.

The _SetAllocator method specifies an allocator-presenter for the VMR. Applications can use this method to provide their own custom allocator-presenter objects.

Syntax

  HRESULT _SetAllocator(
    IVMRSurfaceAllocator *
  pAllocPresent
  ,
    long 
  ID 
  = -1
  
  );

Parameters

pAllocPresent

[in]  Pointer to the IVMRSurfaceAllocator interface of the allocator-presenter object.

ID

[in]  Optionally, specifies an identifier (ID) for the allocator-presenter object. The default value of -1 indicates that the MSVidVideoRenderer object will create an ID when it builds the filter graph. In that case, the MSVidVideoRenderer object uses the lower 32 bits of the allocator-presenter's IUnknown interface pointer as the ID. Note that the ID is for application use; the VMR does not use it.

Return Values

Returns an HRESULT value. Possible values include the following.

Value Description
S_OK Success.

Requirements

  Header: Dshow.h.

  Library: Quartz.dll.

See Also