KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR

KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR は、ドライバーでハイ ダイナミック レンジ (HDR) ビデオを有効または無効にするために使用されます。 これは、ビデオ ピン専用のピン レベル コントロールです。

用法の要点

Yammer の入手	設定	移行先	プロパティ記述子の種類
はい	はい	ピン留めする	KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR

KSCAMERA_EXTENDEDPROP_HEADER.Flags フィールドに以下のフラグを配置することにより、ビデオの HDR を制御できます。 既定では、ドライバーは VIDEOHDR_OFF に設定する必要があります。

#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON       0x0000000000000001 
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO     0x0000000000000002 

ドライバーがこのコントロールをサポートしている場合は、VIDEOHDR_ON/VIDEOHDR_OFF をサポートする必要があります。

ドライバーがビデオの HDR をサポートしていない場合、ドライバーはこのコントロールを実装しないでください。

このコントロールは、ドライバーのヒントとして機能します。 VIDEOHDR_ON に設定すると、ドライバーはベスト エフォートとしてビデオの HDR を実行する必要があります。

このコントロールの SET 呼び出しは、ビデオ ピンが KSSTATE_RUN 状態にある場合は機能しません。 ドライバーは、ビデオ ピンが実行中の状態で、STATUS_INVALID_DEVICE_STATE を返す場合に、受け取った SET 呼び出しを拒否する必要があります。 GET 呼び出しでは、ドライバーが Flags フィールドの現在の設定を返す必要があります。

以下の表では、フラグの機能について説明します。

フラグ	説明
KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF	これは必須の機能です。 指定すると、ドライバーでビデオの HDR が無効になり、ドライバーはビデオ ストリームでビデオの HDR を実行しないものとします。
KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON	これは必須の機能です。 指定すると、ドライバーでビデオの HDR が有効になり、ドライバーはベスト エフォートとしてビデオの HDR を実行します。 このフラグは、VIDEOHDR_AUTO フラグと VIDEOHDR_OFF フラグと相互に排他的です。
KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO	この機能は任意です。 指定すると、このような機能をサポートするドライバーは、シーン分析に基づいてビデオの HDR を実行するかどうかを決定します。 このフラグは、VIDEOHDR_ON フラグと VIDEOHDR_OFF フラグと相互に排他的です。

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

メンバー	説明
Version	これは 1 である必要があります。
PinId	ビデオ ピンに関連付けられているプレビュー ID である必要があります。
サイズ	これは sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) にする必要があります。
結果	最後の SET 操作のエラー結果を示します。 SET 操作が実行されていない場合は、0 にする必要があります。
機能	上記で定義した、サポートされている KSCAMERA_EXTENDEDPROP_VIDEOHDR_* フラグのビット論理和にする必要があります。
Flags	これは読み取り/書き込みフィールドです。 これは、上記で定義した KSCAMERA_EXTENDEDPROP_VIDEOHDR_* フラグのいずれかになります。

要件

サポートされている最低限のクライアント: Windows 11

ヘッダー: ksmedia.h (Ksmedia.h をインクルード)

関連項目

2.2.2.13 ビデオの HDR コントロール