CBaseAllocator::SetProperties

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Determines the size, number, and alignment of blocks.

Syntax

HRESULT SetProperties(
  ALLOCATOR_PROPERTIES* pRequest,
  ALLOCATOR_PROPERTIES* pActual
);

Parameters

• pRequest
  Allocator properties requested to be set.

• pActual
  Allocator properties actually set.

Return Value

Returns an HRESULT value.

Remarks

The pRequest parameter is filled in by the caller with the requested values for the count, number, and alignment as specified by the ALLOCATOR_PROPERTIES structure.

The pActual parameter is filled in by the allocator with the closest values that it can provide for the request. This method cannot be called unless the allocator has been decommitted using the IMemAllocator::Decommit method.

The values of data members m_lSize, m_lCount, m_lAlignment, and m_lPrefix are set to the corresponding members of the pActual parameter's ALLOCATOR_PROPERTIES structure.

Requirements