次の方法で共有

DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY コールバック関数 (dispmprt.h)

  • [アーティクル]

ターゲットの OS によって選択された色の値を報告します。

構文

DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY DxgkddiSettargetadjustedcolorimetry;

NTSTATUS DxgkddiSettargetadjustedcolorimetry(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN D3DDDI_VIDEO_PRESENT_TARGET_ID TargetId,
  [in] IN DXGK_COLORIMETRY AdjustedColorimetry
)
{...}

パラメーター

[in] hAdapter

[in]アダプターを識別します。

[in] TargetId

[in]ディスプレイ アダプターのビデオ存在ターゲットの識別子。

[in] AdjustedColorimetry

[in]OS がディスプレイ デバイス記述子、すべてのオーバーライド、および調整を処理した後に、このターゲットにアタッチされたモニターの測色関連フィールドを含むDXGK_COLORIMETRY構造体。

戻り値

ドライバーは、指定されたデータに基づいて色の値を更新した場合、STATUS_SUCCESSを返します。

ドライバーが失敗した場合、OS はすべてのパラメーターの標準 SDR 値、709 プライマリ、2.2 ガンマ、8-nit /カラー コンポーネント RGB ワイヤ形式に戻りますが、失敗することは決してないようにドライバーを呼び出しません。 代わりに、ドライバーは、ディスプレイ デバイスの内部表現を標準の SDR に更新する必要もあります。

備考

現在のディスプレイ デバイスでは、色測定に関連するパラメーターの説明が不完全で不正確であることが判明しているため、オーバーライドが必要です。 オーバーライドには、ドライバーのオーバーライドと無効なパラメーターの OS オーバーライドの 2 つの形式があります。 今後の OS バージョンでは、追加のオーバーライドが実装されることが予想されます。 OS が使用しているパラメーターとドライバーの同期を保つために、OS は各ターゲットに対して DxgkDdiSetTargetAdjustedColorimetry を呼び出します。

通常、この呼び出しは、ドライバーがオーバーライドのクエリを実行し、OS 検証が完了した後、表示がアクティブ化される前に 1 回だけ行われます。 OS に他の形式のオーバーライドがある場合は、表示が既にアクティブになった後に到着する可能性があります。 この場合も、OS はドライバーを更新します。ドライバーは、2 つのフレーム内で表示パイプラインに必要な更新を行う必要があります。 必要に応じて、ドライバーは、変更を適用するために表示出力をグリッチする必要があります。

DXGK_COLORIMETRYの FormatBitDepths と StandardColorimetryFlags は 0 に設定されます。これらは機能フィールドであるため、クエリでのみ有効です。

この関数は常にパッシブ レベルで呼び出されるため、サポート コードは可能な限りページング可能にする必要があります。

必要条件

要件 価値
ターゲット プラットフォーム の ウィンドウズ
ヘッダー dispmprt.h