다음을 통해 공유


GetPointerInfoHistory 함수(winuser.h)

지정된 포인터에 대한 현재 메시지로 병합된 개별 입력(있는 경우)과 연결된 정보를 가져옵니다. 가장 최근의 입력은 반환된 기록에 포함되며 GetPointerInfo 함수에서 반환된 가장 최근 입력과 동일합니다.

구문

BOOL GetPointerInfoHistory(
  [in]            UINT32       pointerId,
  [in, out]       UINT32       *entriesCount,
  [out, optional] POINTER_INFO *pointerInfo
);

매개 변수

[in] pointerId

정보를 검색할 포인터의 식별자입니다.

[in, out] entriesCount

pointerInfo가 가리키는 버퍼의 구조 개수를 지정하는 변수에 대한 포인터입니다. GetPointerInfoHistory가 성공하면 entriesCount가 사용 가능한 총 구조체 수로 업데이트됩니다. 사용 가능한 총 구조체 수는 GetPointerInfo 호출에서 반환된 POINTER_INFO 구조체의 historyCount 필드와 동일합니다.

[out, optional] pointerInfo

포인터 정보를 수신할 POINTER_INFO 구조체 배열의 주소입니다. *entriesCount가 0인 경우 이 매개 변수는 NULL일 수 있습니다.

반환 값

함수가 성공하면 반환 값은 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

애플리케이션이 포인터 입력 메시지를 생성할 때만큼 빠르게 처리하지 않으면 일부 이동이 병합될 수 있습니다. 애플리케이션이 병합 가능한 포인터 메시지를 받으면 GetPointerInfoHistory 함수를 사용하여 메시지에 병합된 모든 개별 입력(있는 경우)에 대한 정보를 검색할 수 있습니다. 검색된 정보는 호출 스레드에서 가장 최근에 검색한 포인터 메시지와 연결됩니다. 호출 스레드가 다음 메시지를 검색하면 이전 메시지와 연결된 정보를 더 이상 사용할 수 없습니다.

검색된 정보는 역순으로 나타나며 반환된 배열의 첫 번째 행에 가장 최근 항목이 있습니다. 가장 최근 항목은 GetPointerInfo 함수에서 반환한 항목과 동일합니다.

제공된 버퍼의 행 수가 사용 가능한 모든 기록 항목을 보유하기에 충분하지 않은 경우 이 함수는 가장 최근 항목이 포함된 버퍼와 사용 가능한 총 항목 수를 포함하는 *entriesCount 로 성공합니다.

포인터 프레임에 지정된 포인터 외에 추가 포인터가 없으면 이 함수는 성공하고 지정된 포인터에 대한 정보만 반환합니다.

포인터 프레임과 연결된 정보를 더 이상 사용할 수 없는 경우 이 함수는 마지막 오류가 ERROR_NO_DATA 설정되어 실패합니다.

호출 스레드가 포인터 메시지가 전달된 창(입력이 원래 전달되었거나 메시지가 전달된 위치)을 소유하지 않는 경우 이 함수는 마지막 오류가 ERROR_ACCESS_DENIED 설정하여 실패합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 winuser.h(Windows.h 포함)
라이브러리 User32.lib
DLL User32.dll

참조

함수

GetPointerFrameInfo

GetPointerFrameInfoHistory

GetPointerInfo