KSCAMERA_PROFILE_INFO 結構 (ksmedia.h)

  • 發行項

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

GUID，代表配置檔的唯一標識符。 此 GUID 可能是代表自定義配置檔的唯一 IHV/OEM 建立 GUID，也可能是預先定義的 GUID。

此欄位不得設定為 KSCAMERAPROFILE_Legacy。 相機驅動程式不得發佈舊版配置檔。 如果應用程式尚未指出可以支援配置檔，則舊版配置檔標識元會在擷取引擎/媒體擷取初始化期間傳送至相機驅動程式。

在這種情況下，相機驅動程式必須將其行為還原為作業的 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。

規格需求

需求 值
標頭 ksmedia.h (包含 Ksmedia.h)