IddCxMonitorQueryHardwareCursor3-Funktion (iddcx.h)

Artikel
02/29/2024

Ein indirekter Anzeigetreiber ruft IddCxMonitorQueryHardwareCursor3 auf, um die aktuellen Hardwarecursorinformationen für den angegebenen Monitor abzurufen. Diese Funktionsversion fügt die SDR-Weißstufe hinzu, die ein Treiber auf den Cursor anwenden muss, wenn sich der Monitor in einem HDR-Modus befindet.

Syntax

HRESULT IddCxMonitorQueryHardwareCursor3(
  IDDCX_MONITOR                 MonitorObject,
  const IDARG_IN_QUERY_HWCURSOR *pInArgs,
  IDARG_OUT_QUERY_HWCURSOR3     *pOutArgs
);

Parameter

MonitorObject

[in] Ein IDDCX_MONITOR -Objekt, bei dem es sich um das von IddCxMonitorCreate erstellte Betriebssystemkontexthandle des Monitors handelt.

pInArgs

Zeiger auf eine IDARG_IN_QUERY_HWCURSOR-Struktur , die die Eingabeargumente dieser Funktion enthält.

pOutArgs

Zeiger auf eine IDARG_OUT_QUERY_HWCURSOR3 Struktur, in der die aktuellen Hardwarecursorinformationen des Monitors zurückgegeben werden.

Rückgabewert

IddCxMonitorQueryHardwareCursor2 gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben. Ein Fehlercode von STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY ist ein vorübergehender Fehler, der angibt, dass sich das MonitorObject derzeit nicht in einem aktiven Pfad befindet.

Hinweise

IddCxMonitorQueryHardwareCursor3 ruft die aktuellen Hardwarecursorinformationen für den angegebenen Monitor ab und platziert sie in den vom Aufrufer bereitgestellten Puffer, auf den pOutArgs zeigt. Diese Funktion ist iddCxMonitorQueryHardwareCursor2 sehr ähnlich, stellt aber zusätzlich den Wert der SDR-Weißebene bereit. Die SDR-Weißstufe ist erforderlich, da alle Cursorbilder im SDR-Format vorliegen und der Treiber sicherstellen muss, dass sie mit der richtigen Helligkeit angezeigt werden.

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