IMFSampleGrabberSinkCallback interface (mfidl.h)

Callback interface to get media data from the sample-grabber sink.

Inheritance

The IMFSampleGrabberSinkCallback interface inherits from IMFClockStateSink. IMFSampleGrabberSinkCallback also has these types of members:

Methods

The IMFSampleGrabberSinkCallback interface has these methods.

 
IMFSampleGrabberSinkCallback::OnProcessSample

Called when the sample-grabber sink receives a new media sample. (IMFSampleGrabberSinkCallback.OnProcessSample)
IMFSampleGrabberSinkCallback::OnSetPresentationClock

Called when the presentation clock is set on the sample-grabber sink.
IMFSampleGrabberSinkCallback::OnShutdown

Called when the sample-grabber sink is shut down.

Remarks

The sample-grabber sink enables an application to get data from the Media Foundation pipeline without implementing a custom media sink. To use the sample-grabber sink, the application must perform the following steps:

  1. Implement the IMFSampleGrabberSinkCallback interface.
  2. Call MFCreateSampleGrabberSinkActivate, passing in the IMFSampleGrabberSinkCallback interface pointer. This function returns an IMFActivate object.
  3. Create a topology that includes an output node with the sink's IMFActivate object.
  4. Pass this topology to the Media Session.
During playback, the sample-grabber sink calls methods on the application's callback.

You cannot use the sample-grabber sink to get protected content.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header mfidl.h

See also

IMFClockStateSink

Media Foundation Interfaces