estrutura IDARG_OUT_QUERY_HWCURSOR3 (iddcx.h)

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

Sintaxe

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

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 IddCxMonitorQueryHardwareCursor3. 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.

SdrWhiteLevel

[out] O nível de branco para o cursor, em nits, a ser usado ao redigir com conteúdo HDR.

Comentários

Para obter mais informações sobre o suporte ao HDR, consulte Atualizações do IddCx versão 1.10.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 11, versão 22H2 Atualização de setembro (IddCx versão 1.10)
Cabeçalho	iddcx.h

Confira também

IddCxMonitorQueryHardwareCursor3