IMemAllocatorCallbackTemp::GetFreeCount method

The GetFreeCount method returns the number of free media samples. This number equals the total number of media samples minus the number of samples that are currently held by filters.

Syntax


HRESULT GetFreeCount(
  [out] LONG *plBuffersFree
);

Parameters

plBuffersFree [out]

Pointer to a variable that receives the number of free media samples.

Return value

Returns an HRESULT value. Possible values include the following.

Return codeDescription
E_POINTER

NULL pointer argument

S_OK

Success

 

Remarks

A filter holds a sample by keeping a reference count on it. It releases the sample by releasing the reference count.

Until the allocator is committed, the samples are not guaranteed to be allocated.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Strmif.h (include Dshow.h)

Library

Strmiids.lib

See also

Error and Success Codes
IMemAllocatorCallbackTemp Interface

 

 

Show: