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(데스크톱 창 관리자) 크기 조정을 사용하여 모드 변경을 원활하게 수행할 수 있습니다. 사용자가 더 작은 데스크톱 모드를 사용할 때 단점이 발생합니다. 드라이버에 제공된 데스크톱 이미지가 데스크톱 크기보다 크므로 인코딩 및 전송 대역폭이 낭비됩니다.

이 열거형 값은 데스크톱 모드가 변경되면 OS에 가능한 가장 작은 데스크톱 표면 크기를 사용하도록 지시합니다. 처리 오버헤드가 크거나 전송 대역폭이 제한된 솔루션은 일반적으로 이 플래그를 사용하여 가능한 한 많이 처리하기 위해 데스크톱 이미지 크기를 줄입니다.

이 플래그를 설정하면 데스크톱 해상도가 변경 될 때마다 모드가 변경됩니다.
IDDCX_ADAPTER_FLAGS_CAN_USE_MOVE_REGIONS
값: 0x2
이 플래그는 IddCx v1.7부터 사용되지 않습니다. 드라이버는 여전히 IddCx 1.7 이상에 대해 이 플래그를 설정할 수 있지만 아무런 영향을 주지 않습니다. 드라이버가 Pre-IddCx 1.7에서 실행되도록 설계되고 이 플래그를 설정하는 경우 해당 드라이버에는 이동을 처리하는 논리가 있어야 합니다. 그렇지 않으면 사용자가 IddCx 1.7 이전 시스템에서 실행할 때 시각적 문제가 표시됩니다.

드라이버가 이미지를 인코딩할 때 더티 사각형 외에 OS에서 제공하는 이동 영역을 사용할 수 있는지 여부를 나타냅니다. 드라이버는 이러한 추가 리소스를 생성할 때 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 함께 사용할 때만 유효합니다. 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
이 플래그를 설정하는 드라이버는 데스크톱 업데이트의 더티 지역을 보다 정확하게 추적하도록 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_MODES2IddCxMonitorUpdateModes2 호출에서 보고된 모든 대상 모드가 현재 연결된 모니터와 호환되도록 보장됨을 나타냅니다. 그러면 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

추가 정보

IDDCX_ADAPTER_CAPS

IddCxAdapterInitAsync