[일부 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft 여기에 제공된 정보와 관련하여 명시적이거나 묵시적인 보증을 하지 않습니다.]
상호 작용 컨텍스트에 대한 확장 포인터 형식 정보를 사용하여 포인터 프레임 또는 버퍼 포인터 패킷을 처리합니다.
문법
HRESULT
WINAPI
ProcessPointerFramesInteractionContext2(
_In_ HINTERACTIONCONTEXT interactionContext,
_In_ UINT32 entriesCount,
_In_ UINT32 pointerCount,
_In_reads_(entriesCount * pointerCount) const POINTER_TYPE_INFO *pointerInfo);
HRESULT
WINAPI
BufferPointerPacketsInteractionContext2(
_In_ HINTERACTIONCONTEXT interactionContext,
_In_ UINT32 entriesCount,
_In_reads_(entriesCount) const POINTER_TYPE_INFO *pointerInfo);
매개 변수
- interactionContext
-
상호 작용 컨텍스트에 대한 핸들입니다.
- entriesCount
-
pointerInfo 배열의 항목 수(프레임)입니다. ProcessPointerFramesInteractionContext2의 경우 요소의 총 수는 entriesCount × pointerCount입니다. BufferPointerPacketsInteractionContext2의 경우 총 요소 수입니다.
- pointerCount
-
(ProcessPointerFramesInteractionContext2 에만 해당). 프레임당 포인터 수입니다.
- pointerInfo
-
포인터 입력 데이터를 포함하는 POINTER_TYPE_INFO 구조체의 배열에 대한 포인터입니다.
반환 값
함수가 성공하면 S_OK 반환합니다.
함수가 실패하면 HRESULT 오류 코드가 반환됩니다.
비고
이러한 API는 해당 프로세스PointerFramesInteractionContext 및 BufferPointerPacketsInteractionContext와 동일하게 작동합니다. 유일한 차이점은 POINTER_INFO 버퍼 대신 POINTER_TYPE_INFO 버퍼를 사용하는 것입니다. 이러한 API를 사용하면 상호 작용 컨텍스트가 적절한 경우 확장 포인터 정보 페이로드를 사용할 수 있습니다.
터치 패드 입력의 경우 이러한 API는 해당 API 대신 사용해야 합니다. POINTER_TYPE_INFO 구조의 확장된 정보는 적절한 터치 패드 제스처 인식에 필요합니다.
요구 사항
| 요구 사항 | 가치 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 11 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| Header | InteractionContext.h |
| 라이브러리 | Ninput.lib |
| 동적 링크 라이브러리 (DLL) | Ninput.dll(ProcessPointerFramesInteractionContext2의 경우 서수 2507, BufferPointerPacketsInteractionContext2의 경우 서수 2508) |