EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 콜백 함수(iddcx.h)

아티클
02/29/2024

OS는 EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 호출하여 엔드포인트에 연결된 모니터에 대해 드라이버에서 지원하는 대상 모드 목록을 가져옵니다. 이 콜백은 EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES 비슷하지만 드라이버는 HDR10 및 WCG 대상 모드에 대한 추가 정보를 보고할 수 있습니다.

구문

EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 EvtIddCxMonitorQueryTargetModes2;

NTSTATUS EvtIddCxMonitorQueryTargetModes2(
  IDDCX_MONITOR MonitorObject,
  const IDARG_IN_QUERYTARGETMODES2 *pInArgs,
  IDARG_OUT_QUERYTARGETMODES *pOutArgs
)
{...}

매개 변수

MonitorObject

[in] 대상 모드 목록을 생성할 모니터를 식별하는 OS 생성 컨텍스트 핸들입니다. 이 IDDCX_MONITOR 개체는 IddCxMonitorCreate에 대한 이전 호출에서 반환되었습니다.

pInArgs

[in] EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 사용되는 입력 인수를 포함하는 IDARG_IN_QUERYTARGETMODES2 구조체에 대한 포인터입니다.

pOutArgs

[out] EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 생성된 출력 인수를 포함하는 IDARG_OUT_QUERYTARGETMODES 구조체에 대한 포인터입니다.

반환 값

EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2NTSTATUS 값을 반환합니다. 작업이 성공하면 NT_SUCCESS(상태)이 TRUE와 같은 STATUS_SUCCESS 또는 다른 상태 값을 반환합니다. 그렇지 않으면 적절한 NTSTATUS 오류 코드를 반환합니다.

설명

이 함수는 드라이버가 동일한 추가 모드 정보를 보고할 수 있다는 EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 유사합니다. HDR을 지원하는 드라이버는 이 함수를 구현해야 합니다. HDR을 지원하지 않는 드라이버는 기존 EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES 함수만 노출할 수 있습니다.

IDDCX_TARGET_MODE2::BitsPerComponent 필드를 사용하면 여러 형식과 비트 깊이를 단일 모드로 보고할 수 있습니다. 예를 들어 드라이버는 IDDCX_TARGET_MODE2::BitsPerComponent::Rgb에서 IDDCX_BITS_PER_COMPONENT_8 및 IDDCX_BITS_PER_COMPONENT_10 모두 설정하여 RGB의 구성 요소당 8비트와 10비트를 보고할 수 있습니다. 드라이버는 다른 모드 세부 정보도 다른 경우에만 구성 요소당 다른 비트를 고유 모드로 보고해야 합니다.

IddCxAdapterInitAsync 호출에서 IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 보고하지 않은 경우 SDR WCG 또는 HDR 매개 변수를 사용하여 모드를 반환하는 드라이버가 실패합니다. SDR WCG 및 HDR IDDCX_WIRE_BITS_PER_COMPONENT. BitsPerComponent 매개 변수는 다음과 같습니다.