Funções ProcessPointerFramesInteractionContext2 e BufferPointerPacketsInteractionContext2

[Algumas informações referem-se ao produto pré-lançado que pode ser substancialmente modificado antes de ser lançado comercialmente. Microsoft não faz garantias, expressas ou implícitas, em relação às informações fornecidas aqui.]

Processa quadros de ponteiro ou pacotes de ponteiro de buffers com informações de tipo de ponteiro estendido para um Contexto de Interação.

Sintaxe

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

Parâmetros

interactionContext

Um identificador para o Contexto de Interação.

entriesCount

O número de entradas (quadros) na matriz pointerInfo . Para ProcessPointerFramesInteractionContext2, o número total de elementos é entriesCount × pointerCount. Para BufferPointerPacketsInteractionContext2, esse é o número total de elementos.

pointerCount

(Somente ProcessPointerFramesInteractionContext2 .) O número de ponteiros por quadro.

pointerInfo

Um ponteiro para uma matriz de estruturas de POINTER_TYPE_INFO que contém os dados de entrada do ponteiro.

Valor de retorno

Se a função for bem-sucedida, ela retornará S_OK.

Se a função falhar, ela retornará um código de erro HRESULT .

Observações

Essas APIs funcionam de forma idêntica aos seus equivalentes ProcessPointerFramesInteractionContext e BufferPointerPacketsInteractionContext. Sua única diferença é usar um buffer de POINTER_TYPE_INFO em vez de um buffer de POINTER_INFO . Essas APIs permitem que o Contexto de Interação use o conteúdo de informações de ponteiro estendido quando apropriado.

Para entrada touchpad, essas APIs devem ser usadas em vez de seus equivalentes. As informações estendidas na estrutura de POINTER_TYPE_INFO são necessárias para o reconhecimento adequado de gestos do touchpad.

Requisitos

Consulte também

• RegisterTouchpadCapableWindow
• GetPointerTouchpadInfo
• Guia de programação do Touchpad de precisão
• Referência do Touchpad de precisão