[部分資訊涉及預售產品,可能在商業發行前經過大幅修改。 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);
參數
- 互動背景
-
互動上下文的一個稱號。
- 條目計數
-
指標 Info 陣列中的條目(幀數)。 對於 ProcessPointerFramesInteractionContext2,元素總數為 entriesCount × 指標計數。 對於 BufferPointerPacketsInteractionContext2,這是元素的總數。
- 指標計數
-
(僅限 ProcessPointerFramesInteractionContext2 。)每幀指標數量。
- 指標資訊
-
指向包含指標輸入資料的 POINTER_TYPE_INFO 結構陣列的指標。
返回值
如果函式成功,則會傳回 S_OK。
若函式失敗,則回傳 HRESULT 錯誤碼。
備註
這些 API 的運作方式與其對應的 ProcessPointerFramesInteractionContext 和 BufferPointerPacketsInteractionContext 完全相同。 它們唯一的差別是採用 POINTER_TYPE_INFO 緩衝區而非 POINTER_INFO 緩衝區。 這些 API 使互動上下文能在適當時使用擴展指標資訊有效載荷。
觸控板輸入時,必須使用這些 API 取代它們的對應API。 POINTER_TYPE_INFO結構中擴展的資訊是正確的觸控板手勢辨識所必需的。
要求
| 需求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 11 [僅限桌面應用程式] |
| 最低支援的伺服器 | 不支援 |
| Header | 互動上下文.h |
| 圖書館 | Ninput.lib |
| DLL | Ninput.dll(序數為 ProcessPointerFramesInteractionContext2,序數為 2508,BufferPointerPacketsInteractionContext2 為序數 2508) |