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, Y 및 PositionId 필드가 유효한지 여부를 나타내는 부울 값입니다.

PositionId

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

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

SdrWhiteLevel

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

설명

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 11 버전 22H2 9월 업데이트(IddCx 버전 1.10)
머리글	iddcx.h

추가 정보

IddCxMonitorQueryHardwareCursor3