estructura XINPUT_KEYSTROKE (xinput.h)
Especifica los datos de pulsación de tecla devueltos por XInputGetKeystroke.
Sintaxis
typedef struct _XINPUT_KEYSTROKE {
WORD VirtualKey;
WCHAR Unicode;
WORD Flags;
BYTE UserIndex;
BYTE HidCode;
} XINPUT_KEYSTROKE, *PXINPUT_KEYSTROKE;
Miembros
VirtualKey
Código de clave virtual de la tecla, el botón o el movimiento stick. Consulte XInput.h para obtener una lista de códigos válidos de clave virtual (VK_xxx). Vea también comentarios.
Unicode
Este miembro no se usa y el valor es cero.
Flags
Marcas que indican el estado del teclado en el momento del evento de entrada. Este miembro puede ser cualquier combinación de las marcas siguientes:
| Valor | Descripción |
|---|---|
| XINPUT_KEYSTROKE_KEYDOWN | Se presionó la tecla. |
| XINPUT_KEYSTROKE_KEYUP | Se lanzó la clave. |
| XINPUT_KEYSTROKE_REPEAT | Una repetición de una tecla mantenida. |
UserIndex
Índice del jugador que ha iniciado sesión asociado al dispositivo. Puede ser un valor en el intervalo entre 0 y 3.
HidCode
Código HID correspondiente a la entrada. Si no hay ningún código HID correspondiente, este valor es cero.
Comentarios
Los dispositivos futuros pueden devolver códigos HID y valores de clave virtual que no se admiten en los dispositivos actuales y actualmente no están definidos. Las aplicaciones deben omitir estos valores inesperados.
Un código de tecla virtual es un valor de byte que representa una tecla física determinada en el teclado, no el carácter o los caracteres (posiblemente ninguno) a los que se puede asignar la tecla en función del estado del teclado. El estado del teclado en el momento en que se presiona una tecla virtual modifica el carácter notificado. Por ejemplo, VK_4 podría representar un "4" o "$", dependiendo del estado de la tecla MAYÚS.
Un evento de teclado notificado incluye la tecla virtual que provocó el evento, tanto si la tecla se presionó como si se ha liberado (o se repite) y el estado del teclado en el momento del evento. El estado del teclado incluye información sobre si las teclas CTRL, ALT o MAYÚS están inactivas.
Si el evento de teclado representa un carácter Unicode (por ejemplo, presionando la tecla "A"), el miembro Unicode contendrá ese carácter. De lo contrario, Unicode contendrá el valor cero.
Los códigos válidos de clave virtual (VK_xxx) se definen en XInput.h. Además de los códigos que indican las pulsaciones de teclas, los siguientes códigos indican la entrada del controlador.
| Valor | Descripción |
|---|---|
| VK_PAD_A | Un botón |
| VK_PAD_B | Botón B |
| VK_PAD_X | Botón X |
| VK_PAD_Y | Botón Y |
| VK_PAD_RSHOULDER | Botón derecho del hombro |
| VK_PAD_LSHOULDER | Botón izquierdo del hombro |
| VK_PAD_LTRIGGER | Gatillo izquierdo |
| VK_PAD_RTRIGGER | Gatillo derecho |
| VK_PAD_DPAD_UP | Relleno direccional hacia arriba |
| VK_PAD_DPAD_DOWN | Panel direccional hacia abajo |
| VK_PAD_DPAD_LEFT | Panel direccional izquierdo |
| VK_PAD_DPAD_RIGHT | Panel direccional a la derecha |
| VK_PAD_START | Botón INICIAR |
| VK_PAD_BACK | Botón ATRÁS |
| VK_PAD_LTHUMB_PRESS | Clic de stick de la izquierda |
| VK_PAD_RTHUMB_PRESS | Clic con el stick derecho |
| VK_PAD_LTHUMB_UP | Stick pulgar izquierdo hacia arriba |
| VK_PAD_LTHUMB_DOWN | Stick de pulgar izquierdo hacia abajo |
| VK_PAD_LTHUMB_RIGHT | Stick de pulgar izquierdo a la derecha |
| VK_PAD_LTHUMB_LEFT | Stick de pulgar izquierdo a la izquierda |
| VK_PAD_LTHUMB_UPLEFT | Stick de pulgar izquierdo hacia arriba y hacia la izquierda |
| VK_PAD_LTHUMB_UPRIGHT | Stick pulgar izquierdo hacia arriba y hacia la derecha |
| VK_PAD_LTHUMB_DOWNRIGHT | Stick de pulgar izquierdo hacia abajo y hacia la derecha |
| VK_PAD_LTHUMB_DOWNLEFT | Stick de la izquierda hacia abajo y hacia la izquierda |
| VK_PAD_RTHUMB_UP | Stick analógico derecho hacia arriba |
| VK_PAD_RTHUMB_DOWN | Stick analógico derecho hacia abajo |
| VK_PAD_RTHUMB_RIGHT | Stick analógico derecho hacia la derecha |
| VK_PAD_RTHUMB_LEFT | Stick analógico derecho hacia la izquierda |
| VK_PAD_RTHUMB_UPLEFT | Stick de pulgar derecho hacia arriba y hacia la izquierda |
| VK_PAD_RTHUMB_UPRIGHT | Stick de pulgar derecho arriba y derecho |
| VK_PAD_RTHUMB_DOWNRIGHT | Stick analógico derecho hacia abajo y derecha |
| VK_PAD_RTHUMB_DOWNLEFT | Stick analógico derecho hacia abajo y hacia la izquierda |
Requisitos
| Requisito | Valor |
|---|---|
| Header | xinput.h |