> ## 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::GetUsage

> Obtiene el uso HID que describe la finalidad principal del dispositivo de entrada.

Obtiene el uso HID que describe la finalidad principal del dispositivo de entrada.

## Sintaxis

```cpp theme={null}
void GetUsage(
    GameInputUsage* usage
);
```

### Parámetros

*usage*   \_Out\_\
Tipo: [GameInputUsage](https://docs.xbox.com/es/reference/input/gameinput/structs/gameinputusage.md)\*

Recibe la página de uso HID y el identificador de uso del dispositivo.

### Valor devuelto

Tipo: void

## Comentarios

El uso es un índice HID de dos partes, formado por una página de uso y un identificador de uso, que describe qué es el dispositivo. Por ejemplo, un mando de juego suele notificar la página de uso Generic Desktop (0x01) con el identificador de uso Gamepad (0x05). Si el dispositivo no notifica un uso, ambos miembros de *usage* se establecen en 0.

El uso no cambia durante la vida útil del objeto de dispositivo. Para determinar qué tipos de entrada puede leer GameInput del dispositivo, use [IGameInputDevice::GetSupportedInput](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md) en su lugar.

En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro `usage` 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)\
[IGameInputDevice](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[GameInputUsage](https://docs.xbox.com/es/reference/input/gameinput/structs/gameinputusage.md)\
[IGameInputDevice::GetSupportedInput](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md)

## Historial de versiones

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


## Related topics

- [IGameInputDevice (Contenido de la interfaz)](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [IGameInputDevice::GetDeviceFamily](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicefamily.md)
- [IGameInputDevice::GetDeviceId](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceid.md)
- [IGameInputDevice::GetXInputDeviceIndex](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getxinputdeviceindex.md)
- [IGameInputDevice::GetSupportedInput](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md)