共用方式為

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）