ProcessPointerFramesInteractionContext2 和 BufferPointerPacketsInteractionContext2 函数

[某些信息与预发行的产品有关,该产品在商业发布之前可能会进行大幅修改。 Microsoft对此处提供的信息不作任何明示或暗示的保证。

处理具有交互上下文的扩展指针类型信息的指针帧或缓冲区指针数据包。

Syntax

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 与其对应的 ProcessPointerFramesInteractionContextBufferPointerPacketsInteractionContext 相同。 它们的唯一区别在于获取 POINTER_TYPE_INFO 缓冲区而不是 POINTER_INFO 缓冲区。 这些 API 使交互上下文能够在适当时使用扩展指针信息有效负载。

对于触摸板输入,必须使用这些 API 而不是它们的对应 API。 正确触摸板手势识别需要 POINTER_TYPE_INFO 结构中的扩展信息。

要求

要求 价值
最低支持的客户端 Windows 11 [仅限桌面应用]
支持的最低服务器 无受支持的版本
Header InteractionContext.h
图书馆 Ninput.lib
DLL Ninput.dll(ProcessPointerFramesInteractionContext2 的序号 2507、BufferPointerPacketsInteractionContext2 的序号 2508)

另见