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 Zielmodi abzurufen, die vom Treiber für einen mit dem Endpunkt verbundenen Monitor unterstützt werden. 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, um eine Liste der Zielmodi zu generieren. Dieses IDDCX_MONITOR-Objekt wurde in einem vorherigen Aufruf von IddCxMonitorCreatezurückgegeben.
pInArgs
[in] Zeiger auf eine IDARG_IN_QUERYTARGETMODES2 Struktur, die Eingabeargumente enthält, die von EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2verwendet werden.
pOutArgs
[out] Zeiger auf eine IDARG_OUT_QUERYTARGETMODES Struktur, die Ausgabeargumente enthält, die von EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2generiert 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 Statuswert zurückgegeben, für den NT_SUCCESS(Status) GLEICH WAHR ist. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.
Bemerkungen
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.
Das feld IDDCX_TARGET_MODE2::BitsPerComponent ermöglicht die Meldung mehrerer Formate und Bittiefen in einem einzigen Modus. Beispielsweise kann ein Treiber 8 und 10 Bit pro Komponente in RGB melden, indem sowohl IDDCX_BITS_PER_COMPONENT_8 als auch IDDCX_BITS_PER_COMPONENT_10 in IDDCX_TARGET_MODE2::BitsPerComponent::Rgbfestgelegt werden. 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:
- Ein beliebiger Wert für Rgb- außer IDDCX_BITS_PER_COMPONENT_8oder
- Jeder Wert für YCbCr4444, YCbCr422oder YCbCr420 außer IDDCX_BITS_PER_COMPONENT_NONE.
Weitere Informationen zur HDR-Unterstützung finden Sie unter IddCx Version 1.10-Updates.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 11, Version 22H2 September Update (IddCx, Version 1.10) |
| Header- | iddcx.h |