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

  • [アーティクル]

OS は EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 を呼び出して、モニターの説明をモニターがサポートするモードの一覧に解析するようにドライバーに依頼します。 OS は、( EVT_IDD_CX_PARSE_MONITOR_DESCRIPTIONではなく) このコールバック バージョンを呼び出して、ドライバーが HDR10 または WCG モニター モードに必要な追加情報を報告できるようにします。

構文

EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 EvtIddCxParseMonitorDescription2;

NTSTATUS EvtIddCxParseMonitorDescription2(
  const IDARG_IN_PARSEMONITORDESCRIPTION2 *pInArgs,
  IDARG_OUT_PARSEMONITORDESCRIPTION *pOutArgs
)
{...}

パラメーター

pInArgs

[入力]このコールバック関数の入力引数を含む IDARG_IN_PARSEMONITORDESCRIPTION2 構造体へのポインター。

pOutArgs

[out]このコールバック関数の出力引数を含む IDARG_OUT_PARSEMONITORDESCRIPTION 構造体へのポインター。

戻り値

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

注釈

HDR をサポートするバージョン 1.10 以降の間接ディスプレイ ドライバーでは、この関数をレポート モードに公開する必要があります。 次の IDDCX_WIRE_BITS_PER_COMPONENT 値を設定することは、1.10 より前の関数を使用してモードを作成することと同じです。

  • BitsPerComponent.Rgb から IDDCX_BITS_PER_COMPONENT_8
  • BitsPerComponent.YCbCr444、 BitsPerComponent.YCbCr422 、 BitsPerComponent.YCbCr420 から IDDCX_BITS_PER_COMPONENT_NONE

IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 アダプター フラグを設定していないバージョン 1.10 以降のドライバーは、引き続き 1.10 より前の関数のみを報告できます。

IDDCX_MONITOR_MODE2::BitsPerComponent フィールドは、複数の形式とビット深度を 1 つのモードで報告できるように設計されています。 たとえば、ドライバーは、IDDCX_MONITOR_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_BITS_PER_COMPONENT_8以外の IDDCX_WIRE_BITS_PER_COMPONENT::BitsPerComponent.Rgb の値。または
  • IDDCX_BITS_PER_COMPONENT_NONE以外のYCbCr444、YCbCr422、または YCbCr420 のIDDCX_WIRE_BITS_PER_COMPONENT::BitsPerComponent 値。

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

要件

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

こちらもご覧ください

IDARG_IN_PARSEMONITORDESCRIPTION2

IDARG_OUT_PARSEMONITORDESCRIPTION