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