IAMDevMemoryAllocator::GetInfo

  • Article

This method retrieves information about the memory capabilities.

HRESULT GetInfo(
  DWORD* pdwcbTotalFree,
  DWORD* pdwcbLargestFree,
  DWORD* pdwcbTotalMemory,
  DWORD* pdwcbMinimumChunk
);

Parameters

  • pdwcbTotalFree
    [out] Total free memory size.
  • pdwcbLargestFree
    [out] Retrieves the largest free memory size.
  • pdwcbTotalMemory
    [out] Retrieves the total memory size.
  • pdwcbMinimumChunk
    [out] Retrieves the minimum chunk size, giving granularity and alignment rules.

Return Values

Returns an HRESULT value that depends on the implementation of the interface.

Remarks

Use this method to find out the total amount of memory available. This method returns values for the entire on-board memory that is available on that device. If multiple filters (devices) share the memory, it will return the amount available to that specific device, which might be a portion of the total amount of on-board memory. This amount will be implementation-specific. For example, the on-board memory manager on the codec might be able to access all 32 megabytes (MB) of memory on the card. However, individual pin implementations of IAMDevMemoryAllocator only report a portion of this memory.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.