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

[入力]ターゲット モードの一覧を生成するモニターを識別する OS で生成されたコンテキスト ハンドル。 この IDDCX_MONITOR オブジェクトは、 IddCxMonitorCreate の以前の呼び出しで返されました。

pInArgs

[入力] 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 値を返します。 操作が成功した場合は、NT_SUCCESS(status) が TRUE であるSTATUS_SUCCESSまたは別の状態値を返します。 それ以外の場合は、適切な 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の両方を設定することで、コンポーネントあたり 8 ビットと 10 ビットを RGB で報告できます。 他のモードの詳細も異なる場合、ドライバーはコンポーネントごとに異なるビットのみを一意のモードとして報告する必要があります。

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 の任意の値、または
  • IDDCX_BITS_PER_COMPONENT_NONE以外のYCbCr444、YCbCr422、または YCbCr420 の値。

HDR サポートの詳細については、「 IddCx バージョン 1.10 の更新プログラム」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 11、バージョン 22H2 9 月の更新プログラム (IddCx バージョン 1.10)
Header iddcx.h

こちらもご覧ください

IDARG_IN_QUERYTARGETMODES2

IDARG_OUT_QUERYTARGETMODES