IAMDevMemoryAllocator::GetInfo method (strmif.h)

Article
02/22/2024

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Note The IAMDevMemoryAllocator interface is deprecated.

Retrieves information about the memory capabilities.

Syntax

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

Parameters

[out] pdwcbTotalFree

Pointer to the total free memory size.

[out] pdwcbLargestFree

Pointer to the returned largest free memory size.

[out] pdwcbTotalMemory

Pointer to the returned total memory size.

[out] pdwcbMinimumChunk

Pointer to the returned minimum chunk size, giving granularity and alignment rules.

Return value

Returns an HRESULT value.

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

Requirement	Value
Target Platform	Windows
Header	strmif.h (include Dshow.h)