Función SendInput (winuser.h)

Artículo
03/04/2024

Sintetiza pulsaciones de tecla, movimientos del mouse y clics de botón.

Sintaxis

UINT SendInput(
  [in] UINT    cInputs,
  [in] LPINPUT pInputs,
  [in] int     cbSize
);

Parámetros

[in] cInputs

Tipo: UINT

Número de estructuras de la matriz pInputs .

[in] pInputs

Tipo: LPINPUT

Matriz de estructuras INPUT . Cada estructura representa un evento que se va a insertar en el flujo de entrada del teclado o del mouse.

[in] cbSize

Tipo: int

Tamaño, en bytes, de una estructura INPUT . Si cbSize no es el tamaño de una estructura INPUT , se produce un error en la función.

Valor devuelto

Tipo: UINT

La función devuelve el número de eventos que insertó correctamente en el flujo de entrada del teclado o mouse. Si la función devuelve cero, otro subproceso ya bloqueó la entrada. Para obtener información de error extendida, llame a GetLastError.

Esta función produce un error cuando UIPI la bloquea. Tenga en cuenta que ni GetLastError ni el valor devuelto indicarán que el error fue causado por el bloqueo de UIPI.

Comentarios

Esta función está sujeta a UIPI. Las aplicaciones solo pueden insertar entradas en aplicaciones que estén en un nivel de integridad igual o menor.

La función SendInput inserta los eventos en las estructuras INPUT serialmente en el flujo de entrada del teclado o del mouse. Estos eventos no se intercalan con otros eventos de entrada de teclado o mouse insertados por el usuario (con el teclado o el mouse) o por llamadas a keybd_event, mouse_event u otras llamadas a SendInput.

Esta función no restablece el estado actual del teclado. Las teclas que ya están presionadas cuando se llama a la función pueden interferir con los eventos que esta función genera. Para evitar este problema, compruebe el estado del teclado con la función GetAsyncKeyState y corrija según sea necesario.

Dado que el teclado táctil usa las macros suplentes definidas en winnls.h para enviar la entrada al sistema, un agente de escucha en el enlace de eventos del teclado debe descodificar la entrada que se origina en el teclado táctil. Para obtener más información, vea Suplentes y caracteres complementarios.

Una aplicación de accesibilidad puede usar SendInput para insertar pulsaciones de teclas correspondientes a las teclas de acceso directo de inicio de la aplicación que controla el shell. No se garantiza que esta funcionalidad funcione para otros tipos de aplicaciones.

Ejemplo

//**********************************************************************
//
// Sends Win + D to toggle to the desktop
//
//**********************************************************************
void ShowDesktop()
{
    OutputString(L"Sending 'Win-D'\r\n");
    INPUT inputs[4] = {};
    ZeroMemory(inputs, sizeof(inputs));

    inputs[0].type = INPUT_KEYBOARD;
    inputs[0].ki.wVk = VK_LWIN;
   
    inputs[1].type = INPUT_KEYBOARD;
    inputs[1].ki.wVk = 'D';

    inputs[2].type = INPUT_KEYBOARD;
    inputs[2].ki.wVk = 'D';
    inputs[2].ki.dwFlags = KEYEVENTF_KEYUP;

    inputs[3].type = INPUT_KEYBOARD;
    inputs[3].ki.wVk = VK_LWIN;
    inputs[3].ki.dwFlags = KEYEVENTF_KEYUP;

    UINT uSent = SendInput(ARRAYSIZE(inputs), inputs, sizeof(INPUT));
    if (uSent != ARRAYSIZE(inputs))
    {
        OutputString(L"SendInput failed: 0x%x\n", HRESULT_FROM_WIN32(GetLastError()));
    } 
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll