KsInitializeDeviceProfile 函数 (ks.h)

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

语法

KSDDKAPI NTSTATUS KsInitializeDeviceProfile(
  [in] PKSFILTERFACTORY FilterFactory
);

参数

[in] FilterFactory

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

返回值

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

注解

必须使用此筛选器类型的唯一 GUID 设置 KSFILTERFACTORY 中包含的KSFILTER_DESCRIPTOR结构的 ReferenceGuid 字段。 KSFILTER_DESCRIPTOR的“标志”字段设置了KSFILTER_FLAG_PRIORITIZE_REFERENCEGUID标志。

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

要求

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