GetPointerInfo 함수(winuser.h)
현재 메시지와 연결된 지정된 포인터에 대한 정보를 가져옵니다.
구문
BOOL GetPointerInfo(
[in] UINT32 pointerId,
[out] POINTER_INFO *pointerInfo
);
매개 변수
[in] pointerId
포인터 식별자입니다.
[out] pointerInfo
포인터 정보를 수신하는 POINTER_INFO 구조체의 주소입니다.
반환 값
함수가 성공하면 반환 값은 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
GetPointerInfo 는 포인터 메시지와 연결된 단일 포인터에 대한 정보를 검색합니다.
GetPointerFrameInfo를 사용하여 포인터 집합에 대한 메시지와 연결된 프레임 정보를 검색합니다.
GetPointerInfo에서 반환된 정보는 호출 스레드에서 검색한 가장 최근 포인터 메시지와 연결됩니다. 호출 스레드에서 다음 메시지를 검색하면 이전 메시지와 연결된 정보를 더 이상 사용할 수 없습니다.
애플리케이션이 포인터 입력 메시지를 생성한 만큼 빠르게 처리하지 않으면 일부 메시지가 WM_POINTERUPDATE 메시지로 병합될 수 있습니다. GetPointerInfoHistory를 사용하여 최신 WM_POINTERUPDATE 메시지에서 메시지 기록을 검색합니다.
메시지와 연결된 정보를 더 이상 사용할 수 없는 경우 이 함수는 마지막 오류가 ERROR_NO_DATA 설정하여 실패합니다.
호출 스레드가 포인터 메시지가 전달된 창을 소유하지 않으면 마지막 오류가 ERROR_ACCESS_DENIED 설정되어 이 함수가 실패합니다. 입력이 원래 전달된 창이거나 메시지가 전달된 창일 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h(Windows.h 포함) |
| 라이브러리 | User32.lib |
| DLL | User32.dll |
| API 세트 | ext-ms-win-rtcore-ntuser-wmpointer-l1-1-0(Windows 10 버전 10.0.14393에 도입됨) |