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

Comentarios

Cada elemento es una estructura GameInputRawDeviceReportInfo cuyo miembro kind es GameInputRawOutputReport, 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 GetOutputReportCount para obtener el número de informes de salida, asigne una matriz de ese tamaño y, a continuación, llame a GetOutputReportInfo para rellenarla. Si infoArrayCount es menor que el número de informes de salida, solo se escriben los primeros infoArrayCount elementos. Los informes de salida 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 CreateRawDeviceReport, junto con GameInputRawOutputReport, para crear un informe de salida que pueda enviar con SendRawDeviceOutput. El miembro size indica el número de bytes de datos del informe que espera el dispositivo. En el siguiente ejemplo se muestra cómo recuperar los informes de salida de un dispositivo.
En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro outputReportInfo 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
GetOutputReportCount
GameInputRawDeviceReportInfo
GameInputRawDeviceReportKind
IGameInputRawDeviceReport
CreateRawDeviceReport
SendRawDeviceOutput
Temas avanzados de GameInput
IGameInputDevice

Historial de versiones

Última modificación el 6 de noviembre de 2026