Saltar al contenido principal
Recupera las descripciones de los informes de características 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 características, pase el valor devuelto por GetFeatureReportCount. infoArray   _Out_writes_to_opt_(infoArrayCount, return)
Tipo: GameInputRawDeviceReportInfo*
Puntero a una matriz que recibe una estructura por cada informe de características. 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 características del dispositivo, o 0 si infoArray es nullptr o el dispositivo no tiene informes de características.

Comentarios

Cada elemento es una estructura GameInputRawDeviceReportInfo cuyo miembro kind es GameInputRawFeatureReport, 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 GetFeatureReportCount para obtener el número de informes de características, asigne una matriz de ese tamaño y, a continuación, llame a GetFeatureReportInfo para rellenarla. Si infoArrayCount es menor que el número de informes de características, solo se escriben los primeros infoArrayCount elementos. Los informes de características de un dispositivo no cambian mientras el dispositivo está conectado, por lo que puede consultarlos una vez y almacenar en caché el resultado. Use el miembro id de un elemento como parámetro reportId de GetRawDeviceFeature para leer el informe, o de CreateRawDeviceReport, junto con GameInputRawFeatureReport, para crear un informe que pueda enviar con SetRawDeviceFeature. El miembro size indica el número de bytes de datos del informe. En el siguiente ejemplo se muestra cómo recuperar los informes de características de un dispositivo.

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
GetFeatureReportCount
GameInputRawDeviceReportInfo
GameInputRawDeviceReportKind
IGameInputRawDeviceReport
GetRawDeviceFeature
SetRawDeviceFeature
CreateRawDeviceReport
Temas avanzados de GameInput
IGameInputDevice

Historial de versiones

Última modificación el 6 de noviembre de 2026