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) |