KsPublishDeviceProfile 函数 (ks.h)

  • 项目

调用 KsPublishDeviceProfile API 来发布设备配置文件信息。

语法

KSDDKAPI NTSTATUS KsPublishDeviceProfile(
  [in] PKSFILTERFACTORY       FilterFactory,
  [in] PKSDEVICE_PROFILE_INFO Profile
);

参数

[in] FilterFactory

这与 KsInitializeDeviceProfile API 中使用的 KSFILTERFACTORY 相同。

[in] Profile

这是 KSDEVICE_PROFILE_INFO 类型的相机配置文件。

返回值

相机配置文件信息将仅与 KSCATEGORY_VIDEO_CAMERA 接口类别相关联。 创建的任何不使用此接口类别的筛选器工厂并尝试注册相机配置文件将导致此 API 返回 STATUS_INVALID_PARAMETER。

注解

将为相机驱动程序支持的每个配置文件重复调用此 API。 每个调用可能具有不同的并发和数据范围信息集。 KSCAMERA_PROFILE_INFO的 ProfileId 字段必须是唯一的。 如果使用相同的 ProfileId 并且配置文件信息的内容不同，则后续调用将覆盖以前的配置文件信息。

要求

要求 值
目标平台 通用
标头 ks.h (包括 Ksmedia.h)
Library Ks.lib