COutputQueue.NewSegment 方法

  • 项目

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

方法 NewSegment 将新段传递到输入引脚。

语法

HRESULT NewSegment(
   REFERENCE_TIME tStart,
   REFERENCE_TIME tStop,
   double         dRate
);

参数

tStart

段的起始媒体位置，以 100 纳秒为单位。

tStop

段的结束介质位置，以 100 纳秒为单位。

dRate

处理此段的速率，以原始速率的百分比表示。

返回值

返回 HRESULT 值。

备注

如果对象正在使用线程，它将按顺序将以下项排队：

  • NEW_SEGMENT控件消息。
  • 段数据。

NEW_SEGMENT消息通知线程队列中的下一项将包含段数据。 段数据捆绑在 结构中，声明如下：

struct NewSegmentPacket {
    REFERENCE_TIME tStart;
    REFERENCE_TIME tStop;
    double dRate;
};

线程使用 结构中给定的数据调用输入引脚上的 IPin：：NewSegment 方法。

如果对象未使用线程，它将调用 COutputQueue：：SendAnyway 方法来传递任何挂起的样本。 然后，它会在输入引脚上调用 IPin：：NewSegment 。

要求

要求 值
标头
Outputq.h (包括 Streams.h)
库
Strmbase.lib (零售版本) ;
Strmbasd.lib (调试生成)

另请参阅

COutputQueue 类