Compartilhar via


Função GetStateInteractionContext (interactioncontext.h)

Obtém o estado de contexto de interação atual.

Sintaxe

HRESULT GetStateInteractionContext(
  [in]           HINTERACTIONCONTEXT interactionContext,
  [in, optional] const POINTER_INFO  *pointerInfo,
  [out]          INTERACTION_STATE   *state
);

Parâmetros

[in] interactionContext

Ponteiro para um identificador para o Contexto de Interação.

[in, optional] pointerInfo

Uma estrutura POINTER_INFO que contém informações básicas de ponteiro para o ponteiro de interesse específico. Esse parâmetro pode ser NULL.

[out] state

Uma das constantes da enumeração INTERACTION_STATE.

Valor de retorno

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

Caso contrário, ele retornará um código de erro HRESULT.

Observações

Após o término da interação, o contexto de interação ainda pode estar ocupado relatando inércia ou esperando o segundo toque em um gesto de toque duplo (em geral, se o gesto de vários traços for possível). Essa função permite que o chamador descubra quando é seguro tratar o objeto Contexto de Interação como ocioso. A principal finalidade dessa função é o gerenciamento de pools de contextos de interação.

Requirements

Requirement Value
Cliente mínimo suportado Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2012 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header interactioncontext.h
Library Ninput.lib
de DLL Ninput.dll