EVT_IDD_CX_ADAPTER_COMMIT_MODES2 コールバック関数 (iddcx.h)

OS は EVT_IDD_CX_ADAPTER_COMMIT_MODES2 を呼び出して、アダプター上のモニターのモード変更をドライバーに通知します。

構文

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 EvtIddCxAdapterCommitModes2;

NTSTATUS EvtIddCxAdapterCommitModes2(
  IDDCX_ADAPTER AdapterObject,
  const IDARG_IN_COMMITMODES2 *pInArgs
)
{...}

パラメーター

AdapterObject

[入力]照会対象のアダプターの OS によって生成されたアダプター オブジェクト。 この IDDCX_ADAPTER オブジェクト ハンドルは、 IddCxAdapterInitAsync の以前の呼び出しで返されました。

pInArgs

[入力]EVT_IDD_CX_ADAPTER_COMMIT_MODES2で使用される引数を含むIDARG_IN_COMMITMODES2構造体へのポインター。

戻り値

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 は NTSTATUS 値を返します。 操作が成功した場合は、NT_SUCCESS(status) が TRUE であるSTATUS_SUCCESSまたは別の状態値を返します。 それ以外の場合は、適切な NTSTATUS エラー コードを返します。

注釈

モニターに対してモードがコミットされると、HDR または WCG をサポートする IddCx バージョン 1.10 ドライバーがこの関数を介して呼び出され、物理モニター接続で使用されるコンポーネントごとの色空間とビット数が示されます。 これらの値は、ドライバーによって以前に報告されたターゲット機能とモード パラメーターに基づいています。 FP16 に対するレポート アダプターのサポートが、この関数を公開しない場合はエラーです。

コミット モードで指定された色空間では、スワップチェーン内のすべてのサーフェスに使用されるサーフェス形式は指定されません。 IDDCX_METADATA2で提供されるサーフェスは、引き続きクエリを実行する必要があります。

OS は、そのモニターがアクティブでない場合でも、接続されているすべてのモニターに対して常に IDDCX_PATH2 を提供し、変更されたパスを示します。 パスが非アクティブとマークされている場合、そのパスの表示パイプライン全体の電源がオフになり、モニターにシグナルは送信されません。

新しいパスがコミットされると、ドライバーは、最初のフレームを表示する準備ができるまで黒いイメージを表示するように表示パイプラインをプログラムする必要があります。 これを実現するには、最初のフレームを表示する準備ができるまで WDDM の可視性をオフにしてから、可視性をオンにする必要があります。

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

要件

こちらもご覧ください

IDARG_IN_COMMITMODES2

IDDCX_PATH2

IDDCX_METADATA2