Using the System Device Enumerator
System Device Enumerator提供了一种统一的方法来枚举按类别枚举在用户系统上注册的过滤器。 而且,它可以区分单个硬件设备,即使同一个过滤器支持它们。 这对于使用Windows驱动程序模型(WDM)和KSProxy过滤器的设备特别有用。 例如,用户可能有几个WDM视频捕捉设备,全部由相同的过滤器支持。 系统设备枚举器将它们视为独立的设备实例。
System Device Enumerator通过为特定类别创建枚举器来工作,如音频捕获或视频压缩。 类别枚举器为类别中的每个设备返回一个唯一的名字对象。 类别枚举器自动在类别中包含任何相关的即插即用设备。
按照如下方式使用System Device Enumerator:
1.通过调用CoCreateInstance来创建系统设备枚举器。 类标识符(CLSID)是CLSID_SystemDeviceEnum。
2.通过使用所需类别的CLSID调用ICreateDevEnum :: CreateClassEnumerator来获取类别枚举器。 该方法返回一个IEnumMoniker接口指针。 如果类别为空(或不存在),该方法将返回S_FALSE而不是错误代码。 如果是这样,则返回的IEnumMoniker指针为NULL,并且解引用它将导致异常。 因此,在调用CreateClassEnumerator时显式测试S_OK,而不是调用通常的SUCCEEDED宏。
3.使用IEnumMoniker :: Next方法枚举每个名字对象。 该方法返回一个IMoniker接口指针。 当Next方法到达枚举的末尾时,它也返回S_FALSE,所以再次检查S_OK。
4.要检索设备的友好名称(例如,显示在用户界面中),请调用IMoniker :: BindToStorage方法。
5.要创建和初始化管理设备的DirectShow过滤器,请在名字对象上调用IMoniker :: BindToObject。 调用IFilterGraph :: AddFilter将过滤器添加到图中。
下图说明了这个过程:
以下示例显示如何枚举安装在用户系统上的视频压缩器。 为了简洁,该示例执行最小的错误检查。