IddCxMonitorQueryHardwareCursor2-Funktion (iddcx.h)

Artikel
03/01/2024

Ein indirekter Anzeigetreiber ruft IddCxMonitorQueryHardwareCursor2 auf, um die aktuellen Hardwarecursorinformationen für den angegebenen Monitor abzurufen. Ein Treiber, der HDR-Unterstützung meldet, muss stattdessen IddCxMonitorQueryHardwareCursor3 verwenden.

Syntax

NTSTATUS IddCxMonitorQueryHardwareCursor2(
  IDDCX_MONITOR                 MonitorObject,
  const IDARG_IN_QUERY_HWCURSOR *pInArgs,
  IDARG_OUT_QUERY_HWCURSOR2     *pOutArgs
);

Parameter

MonitorObject

[in] Ein IDDCX_MONITOR -Objekt, bei dem es sich um das betriebssystembezogene Kontexthandle des Monitors handelt, das von IddCxMonitorCreate erstellt wurde.

pInArgs

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

pOutArgs

[out] Zeiger auf eine IDARG_OUT_QUERY_HWCURSOR2 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.

Hinweise

Der Treiber ruft diese Funktion normalerweise nur auf, wenn das Ereignis ausgelöst wurde, das die Cursoraktualisierung signalisiert.

Obwohl IddCxMonitorQueryHardwareCursor2 sowohl von Konsolen- als auch von Remotetreibern verwendet werden kann, sind die zusätzlichen Informationen im Vergleich zu IddCxMonitorQueryHardwareCursor nur für Remotetreiber nützlich.