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 |