Condividi tramite

struttura IDARG_OUT_QUERY_HWCURSOR2 (iddcx.h)

  • Articolo

Una struttura IDARG_OUT_QUERY_HWCURSOR2 è il parametro di output usato da IddCxMonitorQueryHardwareCursor2 per restituire informazioni sul cursore hardware corrente.

Sintassi

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

Members

IsCursorVisible

[out] Valore booleano che indica se il cursore è visibile.

X

[out] Se il cursore è visibile (IsCursorVisible = TRUE), X è la coordinata dello schermo x del pixel della mano superiore sinistra nell'immagine del cursore. Questo campo è valido solo se PositionValid è TRUE. X può essere negativo; ad esempio, quando un punto attivo al centro del cursore viene posizionato in alto a sinistra dello schermo.

Y

[out] Se il cursore è visibile (IsCursorVisible = TRUE), Y è la coordinata dello schermo y del pixel superiore sinistro nell'immagine del cursore. Questo campo è valido solo se PositionValid è TRUE. Y può essere negativo; ad esempio, quando un punto attivo al centro del cursore viene posizionato in alto a sinistra dello schermo.

IsCursorShapeUpdated

[out] Valore booleano che indica se la forma del cursore è stata aggiornata dall'ultima volta che il driver ha chiamato IddCxMonitorQueryHardwareCursor2. Se è stato aggiornato, il sistema operativo aggiorna la struttura CursorShapeInfo e copia i nuovi dati dell'immagine del cursore nel IDARG_IN_QUERY_HWCURSOR. buffer pShapeBuffer .

CursorShapeInfo

[out] Struttura IDDCX_CURSOR_SHAPE_INFO in cui il sistema operativo copia le informazioni sul cursore corrente se il cursore è visibile. Se il cursore non è visibile, il sistema operativo zerorà questa struttura.

PositionValid

[out] Valore booleano che indica se i campi X, Y e PositionId in questa struttura sono validi.

PositionId

[out] ID dell'ultima posizione del cursore ricevuta dal sistema operativo per questo monitoraggio. Il driver può confrontare questo ID con l'ultima posizione del cursore elaborata per sapere se deve elaborare un nuovo aggiornamento della posizione.

Si noti che esistono casi in cui i valori di posizione potrebbero non essere stati modificati, ma il valore ID posizione è cambiato. In questo caso il driver deve elaborare la posizione come se fosse una nuova mossa. PositionId non viene aggiornato se IsCursorVisible cambia ed è valido solo se PositionValid è TRUE.

Requisiti

Requisito Valore
Client minimo supportato Windows 11 versione 22H2
Intestazione iddcx.h

Vedi anche

IddCxMonitorQueryHardwareCursor2