EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 Rückruffunktion (iddcx.h)

Das Betriebssystem ruft EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 auf, um eine Liste der Vom Treiber unterstützten Zielmodi für einen Monitor abzurufen, der mit dem Endpunkt verbunden ist. Dieser Rückruf ähnelt EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES, ermöglicht dem Treiber jedoch, zusätzliche Informationen für HDR10- und WCG-Zielmodi zu melden.

Syntax

EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 EvtIddCxMonitorQueryTargetModes2;

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

Parameter

MonitorObject

[in] Das vom Betriebssystem generierte Kontexthandle, das den Monitor identifiziert, für den eine Liste der Zielmodi generiert werden soll. Dieses IDDCX_MONITOR-Objekt wurde in einem vorherigen Aufruf von IddCxMonitorCreate zurückgegeben.

pInArgs

[in] Zeiger auf eine IDARG_IN_QUERYTARGETMODES2-Struktur , die eingabeargumente enthält, die von EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 verwendet werden.

pOutArgs

[out] Zeiger auf eine IDARG_OUT_QUERYTARGETMODES-Struktur , die Ausgabeargumente enthält, die von EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 generiert werden.

Rückgabewert

EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 gibt einen NTSTATUS-Wert zurück. Wenn der Vorgang erfolgreich ist, wird STATUS_SUCCESS oder ein anderer status Wert zurückgegeben, für den NT_SUCCESS(status) true entspricht. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Hinweise

Diese Funktion ähnelt EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 darin, dass Treiber dieselben Zusätzlichen Modusinformationen melden können. Ein Treiber, der HDR unterstützt, muss diese Funktion implementieren. Treiber, die HDR nicht unterstützen, können nur die vorhandene EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES-Funktion verfügbar machen.

Mit dem Feld IDDCX_TARGET_MODE2::BitsPerComponent können mehrere Formate und Bittiefen in einem einzigen Modus gemeldet werden. Beispielsweise kann ein Treiber 8 und 10 Bits pro Komponente in RGB melden, indem er sowohl IDDCX_BITS_PER_COMPONENT_8 als auch IDDCX_BITS_PER_COMPONENT_10 in IDDCX_TARGET_MODE2::BitsPerComponent::Rgb festlegt. Ein Treiber sollte nur unterschiedliche Bits pro Komponente als eindeutige Modi melden, wenn sich auch andere Modusdetails unterscheiden.

Treiber, die Modi mit SDR WCG- oder HDR-Parametern zurückgeben, schlagen fehl, wenn sie nicht auch IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 im IddCxAdapterInitAsync-Aufruf gemeldet haben. SDR WCG und HDR IDDCX_WIRE_BITS_PER_COMPONENT. BitsPerComponent-Parameter sind:

  • Jeder andere Wert für RGB als IDDCX_BITS_PER_COMPONENT_8 oder
  • Ein beliebiger Wert für YCbCr444, YCbCr422 oder YCbCr420 außer IDDCX_BITS_PER_COMPONENT_NONE.

Weitere Informationen zur HDR-Unterstützung finden Sie unter Updates von IddCx, Version 1.10.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11, Version 22H2 September Update (IddCx Version 1.10)
Kopfzeile iddcx.h

Weitere Informationen

IDARG_IN_QUERYTARGETMODES2

IDARG_OUT_QUERYTARGETMODES