IDARG_OUT_QUERY_HWCURSOR2 Struktur (iddcx.h)

Eine IDARG_OUT_QUERY_HWCURSOR2 Struktur ist der Ausgabeparameter, der von IddCxMonitorQueryHardwareCursor2 verwendet wird, um Informationen zum aktuellen Hardwarecursor zurückzugeben.

Syntax

struct IDARG_OUT_QUERY_HWCURSOR2 {
  BOOL                    IsCursorVisible;
  INT                     X;
  INT                     Y;
  BOOL                    IsCursorShapeUpdated;
  IDDCX_CURSOR_SHAPE_INFO CursorShapeInfo;
  BOOL                    PositionValid;
  UINT                    PositionId;
};

Angehörige

IsCursorVisible

[out] Ein boolescher Wert, der angibt, ob der Cursor sichtbar ist.

X

[out] Wenn der Cursor sichtbar ist (IsCursorVisible = TRUE), ist X- die x Bildschirmkoordinate des oberen linken Pixels im Cursorbild. Dieses Feld ist nur gültig, wenn PositionValid- WAHR ist. X- kann negativ sein; Wenn beispielsweise ein Hotspot in der Mitte des Cursors in der oberen linken Ecke des Bildschirms platziert wird.

Y

[out] Wenn der Cursor sichtbar ist (IsCursorVisible = TRUE), ist Y- die y Bildschirmkoordinate des oberen linken Pixels im Cursorbild. Dieses Feld ist nur gültig, wenn PositionValid- WAHR ist. Y- kann negativ sein; Wenn beispielsweise ein Hotspot in der Mitte des Cursors in der oberen linken Ecke des Bildschirms platziert wird.

IsCursorShapeUpdated

[out] Ein boolescher Wert, der angibt, ob das Cursor-Shape seit dem letzten Mal aktualisiert wurde, IddCxMonitorQueryHardwareCursor2. Wenn sie aktualisiert wurde, aktualisiert das Betriebssystem die CursorShapeInfo Struktur und kopiert die neuen Cursorbilddaten in die IDARG_IN_QUERY_HWCURSOR.pShapeBuffer Puffer.

CursorShapeInfo

[out] Eine IDDCX_CURSOR_SHAPE_INFO Struktur, in der das Betriebssystem die aktuellen Cursorinformationen kopiert, wenn der Cursor sichtbar ist. Wenn der Cursor nicht sichtbar ist, wird diese Struktur vom Betriebssystem nulliert.

PositionValid

[out] Ein boolescher Wert, der angibt, ob die Felder X, Yund PositionId Felder in dieser Struktur gültig sind.

PositionId

[out] Die ID der letzten Cursorposition, die das Betriebssystem für diesen Monitor erhalten hat. Der Treiber kann diese ID mit der letzten Cursorposition vergleichen, die er verarbeitet hat, um zu wissen, ob eine neue Positionsaktualisierung verarbeitet werden soll.

Beachten Sie, dass es Fälle gibt, in denen sich die Positionswerte möglicherweise nicht geändert haben, aber der Positions-ID-Wert geändert wurde. In diesem Fall sollte der Treiber die Position so verarbeiten, als ob es sich um eine neue Verschiebung handelte. PositionId- wird nicht aktualisiert, wenn sich IsCursorVisible ändert und nur gültig ist, wenn PositionValid WAHR ist.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 11, Version 22H2
Header-	iddcx.h

Siehe auch

IddCxMonitorQueryHardwareCursor2