Filter Graph Manager

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

Filter Graph 管理器生成并控制筛选器图。 此对象是 DirectShow 中的中心组件。 应用程序使用它来生成和控制筛选器图。 Filter Graph 管理器还处理控制筛选器图的同步、事件通知和其他方面。 通过调用 CoCreateInstance来创建此对象。

CLSID

创建 Filter Graph 管理器有两个 CLSID:

CLSID 描述
CLSID_FilterGraph 在共享工作线程上创建 Filter Graph 管理器。
CLSID_FilterGraphNoThread 在应用程序线程上创建 Filter Graph 管理器。

 

通常,应用程序应使用CLSID_FilterGraph。 这两个 CLSID 都创建相同的对象,但它们使用不同的线程模型:

  • CLSID_FilterGraph在工作线程上创建 Filter Graph 管理器,该线程由同一进程中的所有CLSID_FilterGraph实例共享。 线程调度筛选器发送的消息,并控制筛选器创建的任何窗口的生存期。
  • CLSID_FilterGraphNoThread在应用程序的线程上创建 Filter Graph 管理器。 如果使用此 CLSID,则调用 CoCreateInstance 的线程必须具有调度消息的消息循环;否则,可能会发生死锁。 此外,在应用程序线程退出之前,它必须释放 Filter Graph 管理器和所有图形对象(例如筛选器、引脚、引用时钟等)。

接口

Filter Graph 管理器公开以下接口:

DirectShow 对象