ksmedia.h) (KSCAMERA_PROFILE_INFO 结构

KSCAMERA_PROFILE_INFO 结构用于唯一标识给定的配置文件。

语法

typedef struct _KSCAMERA_PROFILE_INFO {
  GUID                      ProfileId;
  UINT32                    Index;
  UINT32                    PinCount;
  PKSCAMERA_PROFILE_PININFO Pins;
} KSCAMERA_PROFILE_INFO, *PKSCAMERA_PROFILE_INFO;

成员

ProfileId

表示配置文件的唯一 ID 的 GUID。 此 GUID 可以是表示自定义配置文件的唯一 IHV/OEM 创建的 GUID，也可以是预定义的 GUID。

此字段不得设置为 KSCAMERAPROFILE_Legacy。 相机驱动程序不得发布旧版配置文件。 如果应用程序未指示它可以支持配置文件，则会在捕获引擎/媒体捕获初始化期间将旧版配置文件 ID 发送到相机驱动程序。

在这种情况下，相机驱动程序必须将其行为还原为Windows 8.1操作模式，并仅公开减少的集媒体类型以及相应的KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_EXCLUSIVE_WITH_RECORD和KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_SEQUENCE_EXCLUSIVE_WITH_RECORD功能位，指示相机驱动程序是否能够在缩减集媒体类型内支持同时录制/照片和/或录制/照片序列。

Index

给定 ProfileId 组中的每个配置文件必须具有唯一的 Index 值。 这允许使用 ProfileId + Index 唯一标识设备的任何配置文件。

PinCount

Pin 指向的KSCAMERA_PROFILE_PININFO结构的数目。 此值必须大于 0。

Pins

KSCAMERA_PROFILE_PININFO结构的数组，用于定义此配置文件的每个引脚上支持的媒体类型。 此字段不得为 NULL。

要求