Microsoft DirectX 8.1 (C++)

CImageAllocator::CheckSizes

Internal member function that checks the required buffering properties.

Syntax

HRESULT CheckSizes(
  ALLOCATOR_PROPERTIES *pRequest
);

Parameters

pRequest

Pointer to requested allocator properties.

Return Value

Returns an HRESULT value.

Remarks

The image allocator uses the Microsoft Win32 CreateDIBSection function to allocate its samples. That function accepts as input a pointer to a BITMAPINFO structure that describes the bitmap required. Because the size of the bitmap is therefore fixed according to the BITMAPINFO structure for the video, requests to the allocator for a buffer larger than that will not be granted. This member function, therefore, adjusts the requested size so that it is no larger than the size of the bitmap. If the requested size is smaller than the bitmap size, it returns E_INVALIDARG.

This is a protected member function.

See Also