IDDCX_ADAPTER_FLAGS列挙 (iddcx.h)
IDDCX_ADAPTER_FLAGS は、間接ディスプレイ アダプターのブール機能フラグを指定します。
構文
typedef enum IDDCX_ADAPTER_FLAGS {
IDDCX_ADAPTER_FLAGS_NONE = 0,
IDDCX_ADAPTER_FLAGS_USE_SMALLEST_MODE = 0x1,
IDDCX_ADAPTER_FLAGS_CAN_USE_MOVE_REGIONS = 0x2,
IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER = 0x4,
IDDCX_ADAPTER_FLAGS_PREFER_PHYSICALLY_CONTIGUOUS = 0x8,
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION = 0x10,
IDDCX_ADAPTER_FLAGS_PREFER_PRECISE_PRESENT_REGIONS = 0x20,
IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 = 0x40,
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_TARGET_MODES_MONITOR_COMPATIBLE = 0x80
} ;
定数
IDDCX_ADAPTER_FLAGS_NONE値: 0 アダプターにフラグが設定されていないことを示します。 |
IDDCX_ADAPTER_FLAGS_USE_SMALLEST_MODE値: 0x1 間接表示モデルでは、OS 仮想モードが自動的にサポートされるため、OS はデスクトップ ウィンドウ マネージャー (DWM) を使用したモード変更をフレームごとにシームレスに実行でき、表示モードは変更されません。 欠点は、ユーザーが小さいデスクトップ モードを使用する場合に発生します。ドライバーに提供されるデスクトップ イメージがデスクトップ サイズよりも大きいため、エンコードと送信の帯域幅が無駄になります。 この列挙値は、デスクトップ モードが変更されたときに、可能な限り最小のデスクトップ サーフェス サイズを使用するように OS に指示します。 処理オーバーヘッドが大きい、または伝送帯域幅が制限されているソリューションでは、通常、可能な限り処理するために、このフラグを使用してデスクトップイメージのサイズを小さくします。 このフラグを設定すると、デスクトップの解像度が変更されるたびにモードが変更されます。 |
IDDCX_ADAPTER_FLAGS_CAN_USE_MOVE_REGIONS値: 0x2 このフラグは、IddCx v1.7 以降非推奨となりました。 ドライバーは IddCx 1.7 以降に対してこのフラグを設定できますが、効果はありません。 ドライバーが IddCx 1.7 より前で実行され、このフラグを設定するように設計されている場合、そのドライバーには移動を処理するロジックが必要です。そうしないと、IddCx 1.7 より前のシステムで実行しているときに視覚的な問題がユーザーに表示されます。 イメージのエンコード時に、ドライバーがダーティ レッツに加えて OS によって提供される移動領域を使用できるかどうかを示します。 ドライバーは、これらの追加のリソースを生成するときにコストが発生するため、移動リージョンを使用する場合にのみ、これを TRUE に設定する必要があります。 ドライバーがこれを FALSE に設定すると、OS はすべての移動領域をダーティ レレットに変換します。 |
IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER値: 0x4 ドライバーが、コンソール セッション モニターではなく、リモート セッション モニターをサポートするリモート セッション ドライバーであるかどうかを示します。 リモート セッション ドライバーはコンソール セッション モニターをサポートできず、コンソール セッション ドライバーはリモート セッション モニターをサポートできません。 IddCx バージョン 1.4以降でサポートされています。 |
IDDCX_ADAPTER_FLAGS_PREFER_PHYSICALLY_CONTIGUOUS値: 0x8 ドライバーがスワップ チェーン バッファーに使用する物理的に連続したメモリを優先することを示します。これにより、ドライバーは中間コピーを必要とせずにバッファーを直接スキャンできます。 IddCx バージョン 1.6以降でサポートされています。 |
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION値: 0x10 ドライバーがすべてのカーソル位置の変更を受け取る必要があることを示します。つまり、リモート クライアントからリモート セッションに挿入されたマウス入力と、アプリケーションまたはサーバー上の OS からの API 呼び出しによって引き起こされる手続き型の移動の両方を受け取る必要があります。 このフラグは、IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVERと組み合わせた場合にのみ有効です。 iddCxAdapterInitAsync は、IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION が IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVERなしで設定されている場合に失敗します。 IddCx バージョン 1.7以降でサポートされています。 |
IDDCX_ADAPTER_FLAGS_PREFER_PRECISE_PRESENT_REGIONS値: 0x20 このフラグを設定するドライバーは、デスクトップ更新プログラムのダーティ リージョンをより正確に追跡するように OS に要求しています。 このより正確な追跡には CPU 使用率のオーバーヘッドが少ないため、ドライバーは、小さいダーティ リージョンがドライバーにとって有益な場合にのみ、このフラグを設定する必要があります。 IddCx バージョン 1.8以降でサポートされています。 |
IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16ドライバーが IEEE 半精度浮動小数点 (FP16) スワップチェーン サーフェイスを処理できることを示します。 ドライバーは、HDR または SDR WCG をサポートしていないアダプターの場合でも、IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 を設定する必要があります。 OS は、モニター、ターゲット機能、O 設定などの適切な組み合わせが設定されている場合に、HDR または SDR WC サーフェスとモードをドライバーに送信します。 したがって、IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 を設定するドライバーは、これを可能にする IddCx バージョン 1.10 関数もサポートする必要があります。 HDR10 をサポートするドライバーには、次の機能が必要です。 * スワップチェーン内での FP16 フォーマット サーフェスの受信と処理。 * 指定された SDR 白レベルをマウス カーソルに適用します。 コンソール ドライバーには、次の項目も必要です。 *新しい3x4マトリックスカラー変換を使用してください。 * HDR メタデータを受け入れて使用します。 リモート ドライバーも次の操作を行う必要があります。 * 必要に応じて、色測定と SDR ホワイト レベルを供給します。 IddCx バージョン 1.10以降でサポートされています。 「解説」を参照してください。 |
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_TARGET_MODES_MONITOR_COMPATIBLE値: 0x80 このフラグを設定できるのはリモート ドライバーだけです。 リモート ドライバーでは、IDDCX_ADAPTER_FLAGS_ALL_TARGET_MODES_MONITOR_COMPATIBLE を使用して、モニター記述子に含まれていないターゲット モードを指定できます。 通常、OS は、モニターモードとターゲットモードリストの両方に基づいてモードを選択し、EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION 経由で報告するか、記述子がない場合は EVT_IDD_CX_MONITOR_GET_DEFAULT_DESCRIPTION_MODES、ターゲットモードリストを使用します。 リモート シナリオでは、記述子にないモードが必要になる場合があります。 代わりに、ドライバーはターゲット モードを使用してそれらを記述し、モニター モードに対してチェックしないように OS に示すことができます。 リモート ドライバーは、このフラグを設定すると、EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 と IddCxMonitorUpdateModes2 への呼び出しで報告されるすべてのターゲット モードが、現在接続されているモニターと互換性があることを保証することを示します。 OS は、EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 や EVT_IDD_CX_MONITOR_GET_DEFAULT_DESCRIPTION_MODESを呼び出しません。 IddCx バージョン 1.10以降でサポートされています。 「解説」を参照してください。 |
備考
OS がドライバーの設定 IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 または IDDCX_ADAPTER_FLAGS_ALL_TARGET_MODES_MONITOR_COMPATIBLEを受け入れるかどうかを判断するには、ドライバーは IDD_IS_FUNCTION_AVAILABLE マクロを使用して、バージョン 1.10 DDI のいずれかが存在するかどうかを確認する必要があります。たとえば、IDD_IS_FUNCTION_AVAILABLE(IddCxSwapChainReleaseAndAcquireBuffer2). このマクロは、v1.10 でサポートされている OS では TRUE に評価され、それ以外の場合は false に評価されます。 詳細については、IddCx バージョン 1.10 以降の の 更新プログラムを参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | iddcx.h |
関連項目
IddCxAdapterInitAsyncの