IDARG_OUT_QUERY_HWCURSOR3-Struktur (iddcx.h)

  • Artikel

Eine IDARG_OUT_QUERY_HWCURSOR3-Struktur ist der Ausgabeparameter, der von IddCxMonitorQueryHardwareCursor3 verwendet wird, um Informationen zum aktuellen Hardwarecursor zurückzugeben.

Syntax

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

Member

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 TRUE ist. X kann negativ sein; Beispielsweise, wenn ein Heißpunkt in der Mitte des Cursors oben links auf dem Bildschirm platziert wird.

Y

[out] Wenn der Cursor sichtbar ist (IsCursorVisible = TRUE), ist Y die y-Bildschirmkoordinate des oberen linken Handpixels im Cursorbild. Dieses Feld ist nur gültig, wenn PositionValid TRUE ist. Y kann negativ sein; Beispielsweise, wenn ein Heißpunkt in der Mitte des Cursors oben links auf dem Bildschirm platziert wird.

IsCursorShapeUpdated

[out] Ein boolescher Wert, der angibt, ob das Cursor-Shape seit dem letzten Aufruf des Treibers IddCxMonitorQueryHardwareCursor3 aktualisiert wurde. Wenn es 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 auf Null gesetzt.

PositionValid

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

PositionId

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

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

SdrWhiteLevel

[out] Der Weißwert für den Cursor in Nits, der beim Kompositing mit HDR-Inhalten verwendet werden soll.

Hinweise

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11, Version 22H2 September Update (IddCx Version 1.10)
Kopfzeile iddcx.h

Weitere Informationen

IddCxMonitorQueryHardwareCursor3