EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 Rückruffunktion (iddcx.h)

Das Betriebssystem ruft EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 auf, um den Treiber aufzufordern, eine Monitorbeschreibung in eine Liste der vom Monitor unterstützten Modi zu analysieren. Das Betriebssystem ruft diese Rückrufversion (anstelle von EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION) auf, damit der Treiber zusätzliche Informationen melden kann, die für HDR10- oder WCG-Monitormodi benötigt werden.

Syntax

EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 EvtIddCxParseMonitorDescription2;

NTSTATUS EvtIddCxParseMonitorDescription2(
  const IDARG_IN_PARSEMONITORDESCRIPTION2 *pInArgs,
  IDARG_OUT_PARSEMONITORDESCRIPTION *pOutArgs
)
{...}

Parameter

pInArgs

[in] Zeiger auf eine IDARG_IN_PARSEMONITORDESCRIPTION2-Struktur , die die Eingabeargumente für diese Rückruffunktion enthält.

pOutArgs

[out] Zeiger auf eine IDARG_OUT_PARSEMONITORDESCRIPTION Struktur, die die Ausgabeargumente für diese Rückruffunktion enthält.

Rückgabewert

EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 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

Ein indirekter Anzeigetreiber der Version 1.10 oder höher, der HDR unterstützt, muss diese Funktion für Berichtsmodi verfügbar machen. Das Festlegen der folgenden IDDCX_WIRE_BITS_PER_COMPONENT Werte entspricht dem Erstellen eines Modus über die Funktionen vor 1.10:

  • BitsPerComponent.Rgb zum IDDCX_BITS_PER_COMPONENT_8
  • BitsPerComponent.YCbCr444, BitsPerComponent.YCbCr422 und BitsPerComponent.YCbCr420 auf IDDCX_BITS_PER_COMPONENT_NONE

Treiber der Version 1.10 und höher, die das IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 Adapterflag nicht festlegen, können weiterhin nur die Funktion vor 1.10 melden.

Das Feld IDDCX_MONITOR_MODE2::BitsPerComponent ist so konzipiert, dass mehrere Formate und Bittiefen in einem einzigen Modus gemeldet werden können. 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_MONITOR_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-Parameter können wie folgt sein:

  • Ein beliebiger Wert für IDDCX_WIRE_BITS_PER_COMPONENT::BitsPerComponent.Rgb außer IDDCX_BITS_PER_COMPONENT_8 oder
  • Jeder IDDCX_WIRE_BITS_PER_COMPONENT::BitsPerComponent-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_PARSEMONITORDESCRIPTION2

IDARG_OUT_PARSEMONITORDESCRIPTION