Saltar al contenido principal
Recupera las descripciones de los informes de entrada sin procesar que define el dispositivo.

Sintaxis

Parámetros

infoArrayCount   _In_
Tipo: uint32_t
Número de elementos de infoArray. Para recuperar todos los informes de entrada, pase el valor devuelto por GetInputReportCount. infoArray   _Out_writes_to_opt_(infoArrayCount, return)
Tipo: GameInputRawDeviceReportInfo*
Puntero a una matriz que recibe una estructura por cada informe de entrada. Puede ser nullptr, en cuyo caso no se escribe nada y el método devuelve 0.

Valor devuelto

Tipo: uint32_t El número de elementos escritos en infoArray. Es el menor de infoArrayCount y el número de informes de entrada del dispositivo, o 0 si infoArray es nullptr o el dispositivo no tiene informes de entrada.

Comentarios

Cada elemento es una estructura GameInputRawDeviceReportInfo cuyo miembro kind es GameInputRawInputReport, cuyo miembro id es el identificador de informe definido por el dispositivo y cuyo miembro size es el tamaño de los datos del informe en bytes. Llame a GetInputReportCount para obtener el número de informes de entrada, asigne una matriz de ese tamaño y, a continuación, llame a GetInputReportInfo para rellenarla. Si infoArrayCount es menor que el número de informes de entrada, solo se escriben los primeros infoArrayCount elementos. Los informes de entrada de un dispositivo no cambian mientras el dispositivo está conectado, por lo que puede consultarlos una vez y almacenar en caché el resultado. El miembro id de cada elemento coincide con el identificador de informe devuelto por IGameInputRawDeviceReport::GetReportInfo para los informes sin procesar que IGameInputReading::GetRawReport devuelve de las lecturas de este dispositivo. En el siguiente ejemplo se muestra cómo recuperar los informes de entrada de un dispositivo.
En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro inputReportInfo de la estructura GameInputDeviceInfo devuelta por IGameInputDevice::GetDeviceInfo.

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
GetInputReportCount
GameInputRawDeviceReportInfo
GameInputRawDeviceReportKind
IGameInputRawDeviceReport
IGameInputReading::GetRawReport
Temas avanzados de GameInput
IGameInputDevice

Historial de versiones

Última modificación el 6 de noviembre de 2026