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_INFOProfileId 字段必须是唯一的。 如果使用相同的 ProfileId 并且配置文件信息的内容不同,则后续调用将覆盖以前的配置文件信息。

要求

要求 价值
目标平台 普遍
标头 ks.h (包括 Ksmedia.h)
Ks.lib