KsRegisterFilterWithNoKSPins 函数 （ks.h）

KsRegisterFilterWithNoKSPins 函数向没有内核流式处理引脚的 DirectShow 筛选器注册，因此不要在内核模式式传输。

语法

KSDDKAPI NTSTATUS KsRegisterFilterWithNoKSPins(
  [in]           PDEVICE_OBJECT DeviceObject,
  [in]           const GUID     *InterfaceClassGUID,
  [in]           ULONG          PinCount,
  [in]           BOOL           *PinDirection,
  [in]           KSPIN_MEDIUM   *MediumList,
  [in, optional] GUID           *CategoryList
);

参数

[in] DeviceObject

指向与要注册筛选器的设备对应的 DEVICE_OBJECT 结构的指针。

[in] InterfaceClassGUID

指向表示要注册的类的 GUID 的指针。 例如，这指向 TvTuner 筛选器的KSCATEGORY_TVTUNER。

[in] PinCount

筛选器上的引脚数的计数。

[in] PinDirection

指向布尔值数组的第一个元素的指针，指示筛选器上每个引脚的引脚方向。 输出引脚 TRUE;输入引脚 FALSE。 此数组必须以长度 PinCount。

[in] MediumList

指向 KSPIN_MEDIUM 结构数组的第一个元素的指针，用于定义筛选器上每个引脚的介质。 此数组必须以长度 PinCount。

[in, optional] CategoryList

指向 GUID 数组的第一个元素的指针，用于定义筛选器上每个引脚的类别。 如果存在此参数，则必须 PinCount 长度。

返回值

返回在注册表中创建 FilterData 键的成功或失败。

言论

使用 KsRegisterFilterWithNoKSPins 注册 TvTuners、Crossbars 和类似组件。 KsRegisterFilterWithNoKSPins 创建一个新的注册表项，FilterData，其中包含筛选器上每个引脚的介质和类别（可选）。

此函数仅用于注册没有相应内核引脚的筛选器。 如果成功，KsRegisterFilterWithNoKSPins 会在注册表中创建一个密钥，然后 DirectShow 可以使用该键。

如果编写 BDA 微型驱动程序，请考虑使用 KsFilterFactoryUpdateCacheData 而不是此例程。 有关 KsFilterFactoryUpdateCacheData，请参阅参考页上的详细信息。

有关详细信息，请参阅 AVStream 描述符 和 初始化 AVStream 微型驱动程序。

要求

另请参阅

DEVICE_OBJECT

DRIVER_OBJECT

KsFilterFactoryUpdateCacheData

KsFilterRegisterPowerCallbacks