Saltar al contenido principal
Envía un informe de características sin procesar al dispositivo.

Sintaxis

Parámetros

report   _In_
Tipo: IGameInputRawDeviceReport*
El informe de características que se va a enviar. Créelo llamando a CreateRawDeviceReport con GameInputRawFeatureReport y rellénelo llamando a IGameInputRawDeviceReport::SetRawData.

Valor devuelto

Tipo: HRESULT Devuelve S_OK si el informe se envió al dispositivo. Devuelve GAMEINPUT_E_AGGREGATE_OPERATION_NOT_SUPPORTED si el dispositivo es un dispositivo agregado, u otro código de error si no se puede enviar el informe.

Comentarios

El método SetRawDeviceFeature escribe un informe de características en el dispositivo. El identificador de informe se toma de la estructura GameInputRawDeviceReportInfo del informe, y la carga útil son los datos establecidos con IGameInputRawDeviceReport::SetRawData. Use GetFeatureReportCount y GetFeatureReportInfo para averiguar qué informes de características define un dispositivo y qué tamaño tiene cada uno. Actualmente, los informes de características se exponen para los dispositivos HID. En los dispositivos HID, el primer byte de los datos del informe es el identificador de informe. SetRawDeviceFeature pone el informe en cola para su entrega y devuelve un resultado sin esperar a que el dispositivo lo procese. Un valor devuelto correcto significa que el informe se envió, no que el dispositivo lo aceptara. Para confirmar el nuevo estado, vuelva a leer el informe llamando a GetRawDeviceFeature.
Para casos de uso intermedios y avanzados de la API de GameInput, consulte Temas avanzados de GameInput.

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
GetRawDeviceFeature
GetFeatureReportCount
GetFeatureReportInfo
CreateRawDeviceReport
IGameInputRawDeviceReport
IGameInputDevice

Historial de versiones

Apéndice: Versiones anteriores

v0

En GameInput v0, este método se declaraba con la misma firma, pero no estaba implementado. Para obtener más información, consulte IGameInputDevice::SetRawDeviceFeature (en desuso).
Última modificación el 6 de noviembre de 2026