CPullPin.Receive 方法
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
Receive当 对象从输出引脚接收媒体样本时，将调用 方法。 派生类必须实现此方法。
语法
virtual HRESULT Receive(
IMediaSample *pSample
) = 0;
参数
-
pSample
-
指向媒体示例的 IMediaSample 接口的指针。
返回值
返回 HRESULT 值。 返回除 S_OK 以外的值将停止数据拉取线程。
备注
每当新样本从输出引脚到达时，将调用此方法。 以与 IMemInputPin：：Receive 方法相同的方式编写此方法。
示例上的时间戳指定相对于 CPullPin：：Seek 方法中指定的原始起始位置的字节偏移量。
开始位置向下舍入到最近的对齐边界，停止位置向上舍入到最近的对齐边界。 此外，如果停止位置超过总持续时间，则改用持续时间。
所有时间戳都以字节偏移量乘以 10，000，000（定义为常量 UNITS）给出。 因此，从概念上讲，1 秒是一个字节。 若要查找实际的字节偏移量，请调用 IMediaSample：：GetTime 并将结果除以 UNITS。
要求
| 要求 | 值 |
|---|---|
| 标头 |
|
| 库 |
|