IddCxMonitorQueryHardwareCursor2-Funktion (iddcx.h)

Artikel
02/07/2025

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, das das Betriebssystemkontexthandle des Monitors ist, das von IddCxMonitorCreateerstellt wird.

pInArgs

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

pOutArgs

[out] Zeigen Sie auf eine IDARG_OUT_QUERY_HWCURSOR2 Struktur, in der die aktuellen Hardwarecursorinformationen des Monitors zurückgegeben werden.

Rückgabewert

IddCxMonitorQueryHardwareCursor2 gibt nach Erfolg STATUS_SUCCESS zurück; andernfalls wird ein geeigneter NTSTATUS-Fehlercodezurückgegeben.

Bemerkungen

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

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