IAMWMBufferPassCallback::Notify method (dshowasf.h)

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The Notify method is called by the pin for each buffer that is delivered during streaming.

Syntax

HRESULT Notify(
  [in] INSSBuffer3    *pNSSBuffer3,
  [in] IPin           *pPin,
  [in] REFERENCE_TIME *prtStart,
  [in] REFERENCE_TIME *prtEnd
);

Parameters

[in] pNSSBuffer3

Pointer to the INSSBuffer3 interface exposed on the media sample.

[in] pPin

Pointer to the pin associated with the media stream that the sample belongs to.

[in] prtStart

Start time of the sample.

[in] prtEnd

End time of the sample.

Return value

No particular return value is specified. The calling pin ignores the HRESULT.

Remarks

This method enables an application to examine and act on information in the media buffer before the buffer contents are processed. The application is responsible for knowing the media type on the pin. This information can be obtained by first getting the stream information from the profile and then calling IConfigAsfWriter2::StreamNumFromPin method to determine which pin is associated with each stream.

Requirements

Requirement Value
Target Platform Windows
Header dshowasf.h

See also

DirectShow QASF Reference

IAMWMBufferPassCallback Interface

INSSBuffer3 Interface