COutputQueue.NewSegment 方法

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayerIMFMediaEngine媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayerIMFMediaEngineMedia 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 类