IMFVideoSampleAllocatorCallback::GetFreeSampleCount method (mfidl.h)

Gets the number of video samples that are currently available for use.

Syntax

HRESULT GetFreeSampleCount(
  [out] LONG *plSamples
);

Parameters

[out] plSamples

Receives the number of available samples.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

To get a video sample from the allocator, call the IMFVideoSampleAllocator::AllocateSample method. The AllocateSample method removes a sample from the sample pool and returns it to the caller. When a sample is released, it returns to the pool. The GetFreeSampleCount method returns the count of samples that remain in the sample pool.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header mfidl.h

See also

IMFVideoSampleAllocatorCallback