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