Fungsi ProcessPointerFramesInteractionContext2 dan BufferPointerPacketsInteractionContext2

[Beberapa informasi berkaitan dengan produk pra-rilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersurat maupun tersirat, sehubungan dengan informasi yang diberikan di sini.]

Memproses bingkai penunjuk atau paket penunjuk buffer dengan informasi jenis pointer yang diperluas untuk Konteks Interaksi.

Sintaksis

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);

Parameter-parameternya

interactionContext

Handel ke Konteks Interaksi.

entriesCount

Jumlah entri (bingkai) dalam array pointerInfo . Untuk ProcessPointerFramesInteractionContext2, jumlah total elemen adalah entriesCount × pointerCount. Untuk BufferPointerPacketsInteractionContext2, ini adalah jumlah total elemen.

pointerCount

(ProcessPointerFramesInteractionContext2 saja.) Jumlah pointer per bingkai.

pointerInfo

Penunjuk ke array struktur POINTER_TYPE_INFO yang berisi data input pointer.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi akan mengembalikan kode kesalahan HRESULT .

Komentar

API ini berfungsi identik dengan rekan-rekan mereka ProcessPointerFramesInteractionContext dan BufferPointerPacketsInteractionContext. Satu-satunya perbedaan mereka adalah dalam mengambil buffer POINTER_TYPE_INFO alih-alih buffer POINTER_INFO . API ini memungkinkan Konteks Interaksi untuk menggunakan payload info pointer yang diperluas jika sesuai.

Untuk input touchpad, API ini harus digunakan alih-alih rekan-rekan mereka. Informasi yang diperluas dalam struktur POINTER_TYPE_INFO diperlukan untuk pengenalan gerakan touchpad yang tepat.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 11 [hanya aplikasi desktop]
Server minimum yang didukung Tidak ada yang didukung
Header InteractionContext.h
Perpustakaan Ninput.lib
DLL Ninput.dll (ordinal 2507 untuk ProcessPointerFramesInteractionContext2, ordinal 2508 untuk BufferPointerPacketsInteractionContext2)

Baca juga