共用方式為

IDDCX_ADAPTER_FLAGS列舉 (iddcx.h)

  • 發行項

IDDCX_ADAPTER_FLAGS 指定間接顯示配接器的布爾功能旗標。

Syntax

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 順暢地執行模式變更，) 個別畫面調整，而不需要顯示模式變更。 當使用者使用較小的桌面模式時，就會發生缺點：提供給驅動程式的桌面映射大於桌面大小，因此會浪費編碼和傳輸頻寬。

此列舉值會告知操作系統在桌面模式變更時，使用最小可能的桌面表面大小。 具有大型處理額外負荷或有限傳輸頻寬的解決方案通常會使用此旗標來減少桌面映像大小，以便盡可能處理。

每次變更桌面解析度時，設定此旗標會導致模式變更。
IDDCX_ADAPTER_FLAGS_CAN_USE_MOVE_REGIONS
值： 0x2
從 IddCx v1.7開始，此旗標已被取代。 驅動程式仍然可以為IddCx 1.7和更新版本設定此旗標，但不會有任何作用。 如果驅動程式設計為在IddCx 1.7之前執行並設定此旗標，該驅動程式必須有邏輯來處理移動;否則，使用者在IddCx 1.7系統上執行時會看到視覺問題。

指出驅動程式是否可以在編碼影像時，使用OS所提供的行動區域， 驅動程式只有在使用行動區域時，才應該將此設定為 TRUE，因為作業系統在產生這些額外資源時會產生成本。 如果驅動程式將此設定為 FALSE，OS 會將所有行動區域轉換為已變更的 rect。
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 結合時，此旗標才有效。 如果未設定IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION而不IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER，IddCxAdapterInitAsync 將會失敗。

從 IddCx 1.7版開始支援。
IDDCX_ADAPTER_FLAGS_PREFER_PRECISE_PRESENT_REGIONS
值： 0x20
設定此旗標的驅動程式會要求操作系統更精確地追蹤桌面更新的已變更區域。 此更精確的追蹤具有較小的CPU使用量額外負荷，因此驅動程式只有在較小型的中途區域對驅動程式有説明時，才應該設定此旗標。

從 IddCx 1.8版開始支援。
IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16
表示驅動程式可以處理 IEEE 半精確度浮點數， (FP16) 交換鏈表面。 驅動程式應該為不支援 HDR 或 SDR WCG 的適配卡設定 IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 。 當監視、目標功能、O 設定等正確組合時，OS 會將 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 ，以及目標模式清單。 遠端案例可能需要不在描述項中的模式。 相反地，驅動程式可以使用目標模式來描述它們，並指示他們不應該針對監視模式檢查的操作系統。

當遠端驅動程式設定此旗標時，表示呼叫 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 版 DIS 是否存在;例如 IDD_IS_FUNCTION_AVAILABLE(IddCxSwapChainReleaseAndAcquireBuffer2)。 此宏會在 v1.10 支援的 OS 上評估為 TRUE，否則為 false。 如需詳細資訊，請參閱iddCx 1.10版和更新版本的 匯報。

規格需求

需求 值
標頭 iddcx.h

另請參閱

IDDCX_ADAPTER_CAPS

IddCxAdapterInitAsync