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 をインクルード)