> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IGameInputDevice::GetMouseInfo

> Recupera las propiedades de mouse del dispositivo, como los botones que admite, la frecuencia de muestreo y las ruedas de desplazamiento.

Recupera las propiedades de mouse del dispositivo, como los botones que admite, la frecuencia de muestreo y las ruedas de desplazamiento.

## Sintaxis

```cpp theme={null}
bool GetMouseInfo(
    GameInputMouseInfo* info
);
```

### Parámetros

*info*   \_Out\_\
Tipo: [GameInputMouseInfo](https://docs.xbox.com/es/reference/input/gameinput/structs/gameinputmouseinfo.md)\*

Puntero a una estructura `GameInputMouseInfo` que recibe las propiedades de mouse del dispositivo. Si el dispositivo no admite la entrada de mouse, todos los miembros de la estructura se establecen en cero.

### Valor devuelto

Tipo: bool

`true` si el dispositivo admite la entrada de mouse y se rellenó *info*; de lo contrario, `false`.

## Comentarios

El método `GetMouseInfo` copia las propiedades de mouse del dispositivo en la estructura proporcionada por el autor de la llamada. Un dispositivo admite la entrada de mouse cuando el valor devuelto por [GetSupportedInput](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md) incluye `GameInputKindMouse`. Si el dispositivo no admite la entrada de mouse, `GetMouseInfo` inicializa *info* con ceros y devuelve `false`.

El miembro `supportedButtons` indica qué [GameInputMouseButtons](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputmousebuttons.md) tiene el mouse, y los miembros `hasWheelX` y `hasWheelY` indican si el mouse tiene ruedas de desplazamiento horizontal y vertical. El estado del mouse se lee de las lecturas mediante [IGameInputReading::GetMouseState](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getmousestate.md).

Las propiedades que devuelve este método son fijas durante la vida útil del dispositivo, por lo que puede consultarlas una vez (por ejemplo, cuando se conecta el dispositivo) y almacenar en caché el resultado.

En el siguiente ejemplo se muestra cómo consultar las propiedades de mouse de un dispositivo.

```cpp theme={null}
GameInputMouseInfo info;
if (device->GetMouseInfo(&info))
{
    if (info.hasWheelY)
    {
        // Enable scroll-wheel controls.
    }
}
```

En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro `mouseInfo` de la estructura [GameInputDeviceInfo](https://docs.xbox.com/es/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) devuelta por [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md).

## Requisitos

**Encabezado:** GameInput.h

**Biblioteca:** gameinput.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Información general de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-overview.md)\
[GameInputMouseInfo](https://docs.xbox.com/es/reference/input/gameinput/structs/gameinputmouseinfo.md)\
[GetSupportedInput](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md)\
[GameInputKind](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputkind.md)\
[GameInputMouseButtons](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputmousebuttons.md)\
[IGameInputReading::GetMouseState](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getmousestate.md)\
[IGameInputDevice](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## Historial de versiones

| Versión | Cambios |
| - | - |
| **v4** | Se introdujo. |


## Related topics

- [GameInputMouseInfo](https://docs.xbox.com/es/reference/input/gameinput/structs/gameinputmouseinfo.md)
- [IGameInputDevice::GetInputReportInfo](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getinputreportinfo.md)
- [IGameInputDevice::GetKeyboardInfo](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getkeyboardinfo.md)
- [IGameInputDevice::GetGamepadInfo](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getgamepadinfo.md)
- [IGameInputDevice::GetSensorsInfo](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsensorsinfo.md)