EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 コールバック関数 (iddcx.h)
OS は EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 を呼び出して、エンドポイントに接続されているモニターのドライバーでサポートされているターゲット モードの一覧を取得します。 このコールバックは EVT_IDD_CX_MONITOR_QUERY_TARGET_MODESに似ていますが、ドライバーは HDR10 および WCG ターゲット モードの追加情報を報告できます。
構文
EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 EvtIddCxMonitorQueryTargetModes2;
NTSTATUS EvtIddCxMonitorQueryTargetModes2(
IDDCX_MONITOR MonitorObject,
const IDARG_IN_QUERYTARGETMODES2 *pInArgs,
IDARG_OUT_QUERYTARGETMODES *pOutArgs
)
{...}
パラメーター
MonitorObject
[in]ターゲット モードの一覧を生成するモニターを識別する OS によって生成されるコンテキスト ハンドル。 この IDDCX_MONITOR オブジェクトは、IddCxMonitorCreateへの以前の呼び出しで返されました。
pInArgs
[in]EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2によって使用される入力引数を含む IDARG_IN_QUERYTARGETMODES2 構造体へのポインター。
pOutArgs
[out]EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2によって生成された出力引数を含む IDARG_OUT_QUERYTARGETMODES 構造体へのポインター。
戻り値
EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 は、NTSTATUS 値を返します。 操作が成功すると、STATUS_SUCCESSまたは NT_SUCCESS(status) が TRUE の別の状態値が返されます。 それ以外の場合は、適切な NTSTATUS エラー コードが返されます。
備考
この関数は、ドライバーが同じ追加モード情報を報告できるようにするという点で、EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 に似ています。 HDR をサポートするドライバーは、この関数を実装する必要があります。HDR をサポートしていないドライバーは、既存の EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES 関数のみを公開できます。
IDDCX_TARGET_MODE2::BitsPerComponent フィールドを使用すると、複数の形式とビット深度を 1 つのモードで報告できます。 たとえば、ドライバーは、IDDCX_TARGET_MODE2::BitsPerComponent::Rgbで IDDCX_BITS_PER_COMPONENT_8 と IDDCX_BITS_PER_COMPONENT_10 の両方を設定することで、RGB のコンポーネントあたり 8 ビットと 10 ビットを報告できます。 ドライバーは、他のモードの詳細も異なる場合にのみ、コンポーネントごとに異なるビットを一意のモードとして報告する必要があります。
SDR WCG または HDR パラメーターを使用してモードを返すドライバーは、IddCxAdapterInitAsync 呼び出しで IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 も報告していない場合は失敗します。 SDR WCG と HDR IDDCX_WIRE_BITS_PER_COMPONENT。BitsPerComponent パラメーターは次のとおりです。
- IDDCX_BITS_PER_COMPONENT_8以外 Rgb の任意の値、または
- YCbCr444、YCbCr422、または YCbCr420IDDCX_BITS_PER_COMPONENT_NONE以外の値。
HDR サポートの詳細については、iddCx バージョン 1.10 更新プログラム を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 11 バージョン 22H2 September Update (IddCx バージョン 1.10) |
| ヘッダー | iddcx.h |