IMFVideoSampleAllocatorCallback::SetCallback method (mfidl.h)

Sets the callback object that receives notification whenever a video sample is returned to the allocator.

Syntax

HRESULT SetCallback(
  [in] IMFVideoSampleAllocatorNotify *pNotify
);

Parameters

[in] pNotify

A pointer to the IMFVideoSampleAllocatorNotify interface that receives notification, or NULL to remove the callback.

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. When the sample is released, it returns to the pool of available samples. When this happens, the allocator invokes the IMFVideoSampleAllocatorNotify::NotifyRelease callback.

The allocator holds at most one callback pointer. Calling this method again replaces the previous callback pointer.

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