Função CreateSyntheticPointerDevice2

[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.]

Cria um dispositivo de ponteiro sintético usando os parâmetros associados. A entrada pode ser injetada usando esse dispositivo por meio de InjectSyntheticPointerInput. Quando o dispositivo de injeção não for mais necessário, ele deverá ser limpo por meio de DestroySyntheticPointerDevice.

Sintaxe

WINUSERAPI
HSYNTHETICPOINTERDEVICE
WINAPI
CreateSyntheticPointerDevice2(
    _In_ SYNTHETIC_DEVICE_CREATION_PARAMS* pParams);

Parâmetros

pParams

Um ponteiro para uma estrutura SYNTHETIC_DEVICE_CREATION_PARAMS que contém os parâmetros do dispositivo.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será um identificador para o dispositivo de ponteiro sintético.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Observações

O CreateSyntheticPointerDevice existente não pode ser usado para criar dispositivos touchpad, pois os touchpads devem ser criados com um tamanho físico.

SYNTHETIC_DEVICE_CREATION_OPTIONS

Opções para criar um dispositivo de ponteiro sintético.

typedef enum tagSYNTHETIC_DEVICE_CREATION_OPTIONS
{
    SDCO_NONE                   = 0x0,
    SDCO_PHYSICAL_SIZE          = 0x1,
    SDCO_TOUCHPAD_GESTURE_ONLY  = 0x2,
} SYNTHETIC_DEVICE_CREATION_OPTIONS;
DEFINE_ENUM_FLAG_OPERATORS(SYNTHETIC_DEVICE_CREATION_OPTIONS)
Valor Meaning
SDCO_NONE (0x0) Nenhuma opção especial.
SDCO_PHYSICAL_SIZE (0x1) A entrada injetada é relativa ao dispositivo em vez de à exibição mapeada. Se especificado, as dimensões do dispositivo devem ser fornecidas. Ao injetar entrada usando InjectSyntheticPointerInput, as coordenadas de entrada devem ser especificadas no campo ptHimetricLocation das informações do ponteiro em vez de ptPixelLocation.
SDCO_TOUCHPAD_GESTURE_ONLY (0x2) A entrada do touchpad injetado sempre será tratada como um gesto e não poderá ser reconhecida como movimento do mouse ou cliques. Se não for especificado, o sistema tratará a entrada do touchpad injetada de forma idêntica à entrada do touchpad físico.

SYNTHETIC_DEVICE_CREATION_PARAMS

Uma estrutura que representa os parâmetros para criar um dispositivo de injeção sintética.

typedef struct tagSYNTHETIC_DEVICE_CREATION_PARAMS
{
    POINTER_INPUT_TYPE pointerType;
    ULONG maxCount;
    POINTER_FEEDBACK_MODE feedbackMode;
    HMONITOR hMonitor;
    ULONG deviceWidth;
    ULONG deviceHeight;
    SYNTHETIC_DEVICE_CREATION_OPTIONS options;
} SYNTHETIC_DEVICE_CREATION_PARAMS;

Membros

pointerType

O tipo de dispositivo que está sendo criado (PT_TOUCH, PT_PEN ou PT_TOUCHPAD).

maxCount

O número máximo de contatos que podem ser injetados simultaneamente.

feedbackMode

O modo no qual a entrada injetada tem comentários visuais renderizados.

Hmonitor

O monitor para o qual a entrada injetada é mapeada, se aplicável.

deviceWidth

A largura física do dispositivo em himétrico (1/100 de milímetro).

deviceHeight

A altura física do dispositivo em himétrico (1/100 de milímetro).

Opções

Zero ou mais opções de SYNTHETIC_DEVICE_CREATION_OPTIONS.

Observações

Os campos pointerType e options controlam os valores válidos para os outros campos:

PT_TOUCH:

  • maxCount deve ser maior que 0 e menor ou igual a 256.
  • feedbackMode deve ser POINTER_FEEDBACK_DEFAULT, POINTER_FEEDBACK_INDIRECT ou POINTER_FEEDBACK_NONE.
  • o hMonitor pode ser nullptr (a entrada é mapeada para a área de trabalho virtual) ou um monitor válido.
  • deviceWidth e deviceHeight deverão ser diferentes de zero se SDCO_PHYSICAL_SIZE for especificado e zero, caso contrário.
  • Somente SDCO_PHYSICAL_SIZE é válido para opções (ou SDCO_NONE).

PT_PEN:

  • maxCount deve ser 1.
  • feedbackMode deve ser POINTER_FEEDBACK_DEFAULT, POINTER_FEEDBACK_INDIRECT ou POINTER_FEEDBACK_NONE.
  • o hMonitor pode ser nullptr ou um monitor válido.
  • deviceWidth e deviceHeight deverão ser diferentes de zero se SDCO_PHYSICAL_SIZE for especificado e zero, caso contrário.
  • Somente SDCO_PHYSICAL_SIZE é válido para opções (ou SDCO_NONE).

PT_TOUCHPAD:

  • maxCount deve ser maior que 0 e menor ou igual a 5.
  • feedbackMode deve ser POINTER_FEEDBACK_NONE.
  • o hMonitor deve ser nullptr (a entrada touchpad sempre é mapeada para a área de trabalho virtual por meio do local do mouse).
  • deviceWidth e deviceHeight devem ser diferentes de zero.
  • SDCO_PHYSICAL_SIZE deve ser especificado nas opções, SDCO_TOUCHPAD_GESTURE_ONLY é opcional.

Requisitos

Requisito Valor
Cliente mínimo suportado Windows 11 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Cabeçalho Winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll (ordinal 2690)

Consulte também

  • Last updated on