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
[in]このコールバック関数の入力引数を含む IDARG_IN_PARSEMONITORDESCRIPTION2 構造体へのポインター。
pOutArgs
[out]このコールバック関数の出力引数を含む IDARG_OUT_PARSEMONITORDESCRIPTION 構造体へのポインター。
戻り値
EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 は、NTSTATUS 値を返します。 操作が成功すると、STATUS_SUCCESSまたは NT_SUCCESS(status) が TRUE の別の状態値が返されます。 それ以外の場合は、適切な 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 の任意の値。または
- YCbCr444、YCbCr422、または YCbCr420 の IDDCX_BITS_PER_COMPONENT_NONE以外の任意の IDDCX_WIRE_BITS_PER_COMPONENT::BitsPerComponent 値。
HDR サポートの詳細については、iddCx バージョン 1.10 更新プログラム を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 11 バージョン 22H2 September Update (IddCx バージョン 1.10) |
| ヘッダー | iddcx.h |