IMSVidVideoRenderer2::_SetAllocator method (segment.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

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(
  [in] IVMRSurfaceAllocator *AllocPresent,
  [in] long                 ID
);

Parameters

[in] AllocPresent

Pointer to the IVMRSurfaceAllocator interface of the allocator-presenter object.

[in] ID

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 value

Returns an HRESULT value. Possible values include the following.

Return code Description
S_OK
Success.

Requirements

Requirement Value
Minimum supported client Windows�XP with SP1 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header segment.h (include Msvidctl.h)

See also

IMSVidVideoRenderer2 Interface