estrutura IDARG_OUT_QUERY_HWCURSOR2 (iddcx.h)

Uma estrutura IDARG_OUT_QUERY_HWCURSOR2 é o parâmetro de saída usado por IddCxMonitorQueryHardwareCursor2 para retornar informações sobre o cursor de hardware atual.

Sintaxe

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

Membros

IsCursorVisible

[out] Um valor booliano que indica se o cursor está visível.

X

[out] Se o cursor estiver visível (IsCursorVisible = TRUE), X será a coordenada x da tela do pixel superior esquerdo na imagem do cursor. Esse campo só será válido se PositionValid for TRUE. X pode ser negativo; por exemplo, quando um ponto de acesso no centro do cursor é colocado no canto superior esquerdo da tela.

Y

[out] Se o cursor estiver visível (IsCursorVisible = TRUE), Y será a coordenada de tela y do pixel superior esquerdo na imagem do cursor. Esse campo só será válido se PositionValid for TRUE. Y pode ser negativo; por exemplo, quando um ponto de acesso no centro do cursor é colocado no canto superior esquerdo da tela.

IsCursorShapeUpdated

[out] Um valor booliano que indica se a forma do cursor foi atualizada desde a última vez que o driver chamou IddCxMonitorQueryHardwareCursor2. Se ele tiver sido atualizado, o sistema operacional atualizará a estrutura CursorShapeInfo e copiará os novos dados de imagem do cursor no IDARG_IN_QUERY_HWCURSOR. buffer pShapeBuffer .

CursorShapeInfo

[out] Uma estrutura IDDCX_CURSOR_SHAPE_INFO na qual o sistema operacional copia as informações atuais do cursor se o cursor estiver visível. Se o cursor não estiver visível, o sistema operacional zerará essa estrutura.

PositionValid

[out] Um valor booliano que indica se os campos X, Y e PositionId nessa estrutura são válidos.

PositionId

[out] A ID da última posição do cursor que o sistema operacional recebeu para este monitor. O driver pode comparar essa ID com a última posição do cursor que ele processou para saber se deve processar uma nova atualização de posição.

Observe que há casos em que os valores de posição podem não ter sido alterados, mas o valor da ID da posição foi alterado. Nesse caso, o driver deve processar a posição como se fosse uma nova movimentação. PositionId não será atualizado se IsCursorVisible for alterado e só for válido se PositionValid for TRUE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 11, versão 22H2
Cabeçalho	iddcx.h

Confira também

IddCxMonitorQueryHardwareCursor2