IMemAllocatorCallbackTemp::GetFreeCount
| Microsoft DirectShow 9.0 |
IMemAllocatorCallbackTemp::GetFreeCount
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(
LONG *plBuffersFree
);
Parameters
plBuffersFree
[out] Pointer to a variable that receives the number of free media samples.
Return Values
Returns an HRESULT value. Possible values include the following.
| Return code | Description |
| 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
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also