KsInitializeDeviceProfile 函数 （ks.h）

KsInitializeDeviceProfile API 必须由所有微型端口驱动程序调用，以初始化配置文件存储并发布设备配置文件。

语法

KSDDKAPI NTSTATUS KsInitializeDeviceProfile(
  [in] PKSFILTERFACTORY FilterFactory
);

参数

[in] FilterFactory

这是相机驱动程序创建的 KSFILTERFACTORY，用于唯一标识相机的筛选器工厂。

返回值

如果提供的 KSFILTERFACTORY 不包含与 KSCATEGORY_VIDEO_CAMERA关联的设备接口，则此 API 调用将失败并 STATUS_INVALID_PARAMETER。

言论

需要为此筛选器类型设置 KSFILTERFACTORY 中包含的 KSFILTER_DESCRIPTOR 结构的 ReferenceGuid 字段。 KSFILTER_DESCRIPTOR 的 标志 字段具有 KSFILTER_FLAG_PRIORITIZE_REFERENCEGUID 标志集。

若要从与此 KSFILTERFACTORY的设备接口关联的配置文件存储中删除所有配置文件，驱动程序可以立即调用 KsInitializeDeviceProfile 后跟 KsPersistDeviceProfile。 这将导致空的配置文件信息，这将从配置文件存储中删除配置文件信息。

要求

要求	价值
目标平台	普遍
标头	ks.h （包括 Ksmedia.h）
库	Ks.lib