IMFSampleGrabberSinkCallback2 interface (mfidl.h)

Extends the IMFSampleGrabberSinkCallback interface.

Inheritance

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

Methods

The IMFSampleGrabberSinkCallback2 interface has these methods.

 
IMFSampleGrabberSinkCallback2::OnProcessSampleEx

Called when the sample-grabber sink receives a new media sample. (IMFSampleGrabberSinkCallback2.OnProcessSampleEx)

Remarks

This callback interface is used with the sample-grabber sink. It extends the IMFSampleGrabberSinkCallback interface by adding the OnProcessSampleEx method, which supersedes the IMFSampleGrabberSinkCallback::OnProcessSample method.

The OnProcessSampleEx method adds a parameter that contains the attributes for the media sample. You can use the attributes to get information about the sample, such as field dominance and telecine flags.

To use this interface, do the following:

  1. Implement a callback object that exposes the interface.
  2. Create the sample-grabber sink by calling the MFCreateSampleGrabberSinkActivate function. Pass the callback pointer in the pIMFSampleGrabberSinkCallback parameter.
  3. The sample-grabber sink will call QueryInterface on the callback object.
  4. If the callback object exposes the IMFSampleGrabberSinkCallback2 interface, the sample-grabber sink will use the OnProcessSampleEx callback method. Otherwise, the sample-grabber sink will use the older OnProcessSample callback method.

Requirements

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

See also

IMFSampleGrabberSinkCallback

Media Foundation Interfaces