Fonctions ProcessPointerFramesInteractionContext2 et BufferPointerPacketsInteractionContext2

[Certaines informations concernent le produit préversion qui peut être sensiblement modifié avant sa publication commerciale. Microsoft n’offre aucune garantie, expresse ou implicite, en ce qui concerne les informations fournies ici.]

Traite les trames de pointeur ou les paquets de pointeurs tampons avec des informations de type pointeur étendues pour un contexte d’interaction.

Syntaxe

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

Paramètres

interactionContext

Handle du contexte d’interaction.

entriesCount

Nombre d’entrées (cadres) dans le tableau pointerInfo . Pour ProcessPointerFramesInteractionContext2, le nombre total d’éléments est entriesCount × pointerCount. Pour BufferPointerPacketsInteractionContext2, il s’agit du nombre total d’éléments.

pointerCount

(ProcessPointerFramesInteractionContext2 uniquement.) Nombre de pointeurs par image.

pointerInfo

Pointeur vers un tableau de structures POINTER_TYPE_INFO contenant les données d’entrée de pointeur.

Valeur renvoyée

Si la fonction réussit, elle retourne S_OK.

Si la fonction échoue, elle retourne un code d’erreur HRESULT .

Remarques

Ces API fonctionnent de manière identique à leurs équivalents ProcessPointerFramesInteractionContext et BufferPointerPacketsInteractionContext. Leur seule différence consiste à prendre une mémoire tampon POINTER_TYPE_INFO au lieu d’une mémoire tampon POINTER_INFO . Ces API permettent au contexte d’interaction d’utiliser la charge utile d’informations de pointeur étendue le cas échéant.

Pour l’entrée du pavé tactile, ces API doivent être utilisées au lieu de leurs équivalents. Les informations étendues de la structure POINTER_TYPE_INFO sont requises pour la reconnaissance appropriée des mouvements du pavé tactile.

Exigences

Prérequis Valeur
Client minimum requis Windows 11 [applications de bureau uniquement]
Serveur minimum pris en charge Aucun pris en charge
Header InteractionContext.h
Bibliothèque Ninput.lib
DLL Ninput.dll (ordinal 2507 pour ProcessPointerFramesInteractionContext2, ordinal 2508 pour BufferPointerPacketsInteractionContext2)

Voir également