次の方法で共有

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM

  • [アーティクル]

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM は、ドライバーによって生成されるヒストグラム メタデータを制御するために使用されるプロパティ ID です。 これはプレビュー ピン専用のピン レベル コントロールです。

用法の要点

範囲 コントロール Type

Version 1

ピン留めする

同期

KSCAMERA_EXTENDEDPROP_HEADER.Flags フィールドに以下のフラグを配置することにより、ドライバーの顔検出を制御できます。 既定値は 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 コントロールもサポートする必要があります。

このコントロールの SET 呼び出しは、プレビュー ピンが KSSTATE_STOP 状態より高い状態の場合は影響しません。 ドライバーは、プレビューが停止状態でない場合に受信した SET 呼び出しを拒否し、STATUS_INVALID_DEVICE_STATE を返します。 GET 呼び出しでは、ドライバーが Flags フィールドの現在の設定を返す必要があります。

次の表は、KSCAMERA_EXTENDEDPROP_HEADER 構造体フィールドについて、このコントロールを使用する場合の説明と要件を示します。

メンバー 説明

Version

これは 1 である必要があります。

PinId

写真ピンに関連付けられているプレビュー ID である必要があります。

サイズ

これは sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) である必要があります。

結果

最後の SET 操作のエラー結果を示します。 SET 操作が実行されていない場合は、0 にする必要があります。

機能

0 を指定する必要があります。

Flags

これは読み取り/書き込みフィールドです。 これは、上記で定義した KSCAMERA_EXTENDEDPROP_HISTOGRAM_* フラグのいずれかになります。

要件

ヘッダー

 Ksmedia.h