IMFVideoSampleAllocator::AllocateSample method (mfidl.h)

Gets a video sample from the allocator.

Syntax

HRESULT AllocateSample(
  [out] IMFSample **ppSample
);

Parameters

[out] ppSample

Receives a pointer to the IMFSample interface. The caller must release the interface.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.
MF_E_NOT_INITIALIZED
The allocator was not initialized. Call IMFVideoSampleAllocator::InitializeSampleAllocator or InitializeSampleAllocatorEx::InitializeSampleAllocatorEx.
MF_E_SAMPLEALLOCATOR_EMPTY
No samples are available.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header mfidl.h
Library Mfuuid.lib

See also

IMFVideoSampleAllocator