다음을 통해 공유


IDARG_OUT_QUERY_HWCURSOR3 구조체(iddcx.h)

IDARG_OUT_QUERY_HWCURSOR3 구조체는 현재 하드웨어 커서에 대한 정보를 반환하기 위해 IddCxMonitorQueryHardwareCursor3 사용하는 출력 매개 변수입니다.

통사론

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

회원

IsCursorVisible

[out] 커서가 표시되는지 여부를 나타내는 부울 값입니다.

X

[out] 커서가 표시되는 경우(IsCursorVisible = TRUE) X 커서 이미지에서 왼쪽 위 손 픽셀의 x 화면 좌표입니다. 이 필드는 PositionValid TRUE인 경우에만 유효합니다. X 음수일 수 있습니다. 예를 들어 커서 가운데에 있는 핫 스폿이 화면의 왼쪽 위에 배치되는 경우입니다.

Y

[out] 커서가 표시되는 경우(IsCursorVisible = TRUE) Y 커서 이미지에서 왼쪽 위 손 픽셀의 y 화면 좌표입니다. 이 필드는 PositionValid TRUE인 경우에만 유효합니다. Y 음수일 수 있습니다. 예를 들어 커서 가운데에 있는 핫 스폿이 화면의 왼쪽 위에 배치되는 경우입니다.

IsCursorShapeUpdated

[out] 드라이버가 IddCxMonitorQueryHardwareCursor3을 마지막으로 호출한 이후 커서 셰이프가 업데이트되었는지 여부를 나타내는 부울 값입니다. 업데이트된 경우 OS는 CursorShapeInfo 구조를 업데이트하고 새 커서 이미지 데이터를 IDARG_IN_QUERY_HWCURSOR복사합니다. pShapeBuffer버퍼를.

CursorShapeInfo

[out] 커서가 표시되는 경우 OS가 현재 커서 정보를 복사하는 IDDCX_CURSOR_SHAPE_INFO 구조체입니다. 커서가 표시되지 않으면 OS는 이 구조를 0으로 설정합니다.

PositionValid

[out] 이 구조의 X, YPositionId 필드가 유효한지 여부를 나타내는 부울 값입니다.

PositionId

[out] OS가 이 모니터에 대해 받은 마지막 커서 위치의 ID입니다. 드라이버는 이 ID를 처리한 마지막 커서 위치와 비교하여 새 위치 업데이트를 처리해야 하는지 여부를 알 수 있습니다.

위치 값이 변경되지 않았지만 위치 ID 값이 변경된 경우가 있습니다. 이 경우 드라이버는 새 이동인 것처럼 위치를 처리해야 합니다. PositionIdIsCursorVisible 변경된 경우 업데이트되지 않으며 PositionValid TRUE인 경우에만 유효합니다.

SdrWhiteLevel

[out] HDR 콘텐츠로 작성할 때 사용할 커서의 흰색 수준(nits)입니다.

발언

HDR 지원에 대한 자세한 내용은 IddCx 버전 1.10 업데이트참조하세요.

요구 사항

요구
지원되는 최소 클라이언트 Windows 11 버전 22H2 9월 업데이트(IddCx 버전 1.10)
헤더 iddcx.h

참고 항목

IddCxMonitorQueryHardwareCursor3