共用方式為

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM

  • 發行項

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM 是屬性標識碼，用來控制驅動程式所產生的直方圖元數據。 這是僅限預覽釘選的釘選層級控件。

使用量摘要數據表

範圍 控制 類型

第 1 版

Pin

同步

下列旗標可以放在 KSCAMERA_EXTENDEDPROP_HEADER中。旗標 欄位，以控制驅動程式中的直方圖元數據。 預設值 為 HISTOGRAM_OFF。

#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_OFF      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_ON       0x0000000000000001

此控件必須在 KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA 控件之前使用，以確保配置適當的大小元數據緩衝區。

如果設定為 HISTOGRAM_OFF，驅動程式不得在預覽釘選上傳遞直方圖元數據。 驅動程式不應在其元數據緩衝區大小需求中包含直方圖元數據大小。

如果設定為 HISTOGRAM_ON，驅動程式應該會在預覽釘選上傳遞直方圖元數據。 驅動程式必須在其元數據緩衝區大小需求中包含直方圖元數據大小。

如果驅動程式沒有產生直方圖元數據的功能，驅動程式就不應該實作此控件。 如果驅動程式支援此控件，它也必須支援 KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA 控件。

當預覽釘選處於高於KSSTATE_STOP狀態的任何狀態時，此控件的 SET 呼叫沒有任何作用。 如果預覽狀態不是停止狀態，驅動程式應該拒絕收到的 SET 呼叫，並傳回 STATUS_INVALID_DEVICE_STATE。 在 GET 呼叫中，驅動程式應該會在 [旗標 ] 字段中傳回目前的設定。

下表包含使用 控件時 ，KSCAMERA_EXTENDEDPROP_HEADER 結構欄位的描述和需求。

member 描述

版本

這必須是 1。

PinId

必須是與預覽釘選相關聯的 Pin 識別碼。

大小

這必須是sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。

結果

指出最後一個 SET 作業的錯誤結果。 如果沒有進行 SET 作業，這必須是 0。

功能

必須是 0。

Flags

這是讀取/寫入欄位。 這可以是上述任何 一個KSCAMERA_EXTENDEDPROP_HISTOGRAM_* 旗標。

規格需求

標頭

 Ksmedia.h