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 |