struttura IDARG_OUT_QUERY_HWCURSOR3 (iddcx.h)
Una struttura IDARG_OUT_QUERY_HWCURSOR3 è il parametro di output usato da IddCxMonitorQueryHardwareCursor3 per restituire informazioni sul cursore hardware corrente.
Sintassi
struct IDARG_OUT_QUERY_HWCURSOR3 {
BOOL IsCursorVisible;
INT X;
INT Y;
BOOL IsCursorShapeUpdated;
IDDCX_CURSOR_SHAPE_INFO CursorShapeInfo;
BOOL PositionValid;
UINT PositionId;
UINT SdrWhiteLevel;
};
Membri
IsCursorVisible
[out] Valore booleano che indica se il cursore è visibile.
X
[out] Se il cursore è visibile (IsCursorVisible = TRUE), X è il x coordinata dello schermo del pixel superiore sinistro nell'immagine del cursore. Questo campo è valido solo se PositionValid è TRUE. X può essere negativo; ad esempio, quando un punto critico al centro del cursore viene posizionato in alto a sinistra dello schermo.
Y
[out] Se il cursore è visibile (IsCursorVisible = TRUE), Y è il y coordinata dello schermo del pixel superiore sinistro nell'immagine del cursore. Questo campo è valido solo se PositionValid è TRUE. Y può essere negativo; ad esempio, quando un punto critico 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 IddCxMonitorQueryHardwareCursor3. 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 correnti sul cursore 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, Ye PositionId in questa struttura sono validi.
PositionId
[out] ID dell'ultima posizione del cursore ricevuta dal sistema operativo per questo monitor. 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 viene modificato ed è valido solo se PositionValid è TRUE.
SdrWhiteLevel
[out] Livello bianco per il cursore, in nit, da usare durante la composizione con contenuto HDR.
Osservazioni
Per altre informazioni sul supporto HDR, vedere aggiornamenti iddCx versione 1.10.
Fabbisogno
Requisito | Valore |
---|---|
client minimo supportato | Aggiornamento di settembre di Windows 11, versione 22H2 (IddCx versione 1.10) |
intestazione | iddcx.h |