EVT_IDD_CX_ADAPTER_QUERY_TARGET_INFO callback function (iddcx.h)

Article
10/24/2023

The OS calls an indirect display driver's EVT_IDD_CX_ADAPTER_QUERY_TARGET_INFO callback function to retrieve information about target capabilities.

Syntax

EVT_IDD_CX_ADAPTER_QUERY_TARGET_INFO EvtIddCxAdapterQueryTargetInfo;

NTSTATUS EvtIddCxAdapterQueryTargetInfo(
  IDDCX_ADAPTER AdapterObject,
  IDARG_IN_QUERYTARGET_INFO *pInArgs,
  IDARG_OUT_QUERYTARGET_INFO *pOutArgs
)
{...}

Parameters

AdapterObject

[in] The adapter object of the adapter being queried. This adapter object was returned in a call to IddCxAdapterInitAsync.

pInArgs

[in] A pointer to an IDARG_IN_QUERYTARGET_INFO structure containing input arguments for this function.

pOutArgs

[out] A pointer to an IDARG_OUT_QUERYTARGET_INFO structure containing output arguments for this function.

Return value

If the operation is successful, the callback function must return STATUS_SUCCESS, or another status value for which NT_SUCCESS(status) equals TRUE. Otherwise, the callback should return an appropriate NTSTATUS error code.

Remarks

The OS calls EVT_IDD_CX_ADAPTER_QUERY_TARGET_INFO after a driver calls IddCxMonitorArrival. The OS uses the connector index provided by the driver in the IddCxMonitorCreate call for this monitor.

Specifying IDDCX_BITS_PER_COMPONENT_NONE is valid; however, to enable HDR, current Windows policies require either the ability to send 10 or more bits per component to a monitor or alternatively for the driver to support dithering of more than 8 bits per component down to 8 bits per component. The ability to dither allows HDR to be supported at 4K resolutions over HDMI 2.0.

For more information about HDR support, see IddCx version 1.10 updates.

Requirements

Requirement	Value
Minimum supported client	Windows 11, version 22H2 September Update (IddCx version 1.10)
Header	iddcx.h