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] TargetId

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

[in] AdjustedColorimetry

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

戻り値

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

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

注釈

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

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

DXGK_COLORIMETRYの FormatBitDepths と StandardColorimetryFlags は、機能フィールドであるため、クエリでのみ有効であるため、ゼロになります。

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

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	dispmprt.h