IGameInputDevice::GetRawDeviceFeature

Lee un informe de características sin procesar del dispositivo.

Sintaxis

HRESULT GetRawDeviceFeature(
    uint32_t reportId,
    IGameInputRawDeviceReport** report
);

Parámetros

reportId _In_
Tipo: uint32_t Identificador del informe de características que se va a leer. Debe coincidir con el miembro id de uno de los informes devueltos por GetFeatureReportInfo. report _COM_Outptr_
Tipo: IGameInputRawDeviceReport** Recibe un nuevo objeto IGameInputRawDeviceReport que contiene los datos del informe de características leídos del dispositivo. Se establece en nullptr en caso de error.

Valor devuelto

Tipo: HRESULT Devuelve S_OK si se realiza correctamente. Devuelve E_NOTFOUND si el dispositivo no define un informe de características con el identificador especificado y GAMEINPUT_E_AGGREGATE_OPERATION_NOT_SUPPORTED si el dispositivo es un dispositivo agregado. Devuelve otros códigos de error si no se puede leer el informe del dispositivo.

Comentarios

El método GetRawDeviceFeature solicita al dispositivo el contenido actual de un informe de características y lo devuelve en un nuevo objeto IGameInputRawDeviceReport. El miembro kind de la estructura GameInputRawDeviceReportInfo del informe es GameInputRawFeatureReport, y el tamaño de sus datos coincide con el miembro size del elemento correspondiente devuelto por GetFeatureReportInfo. Lea los datos llamando a GetRawDataSize y a IGameInputRawDeviceReport::GetRawData. Use GetFeatureReportCount y GetFeatureReportInfo para averiguar qué informes de características define un dispositivo. 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. A diferencia de los demás métodos de informes sin procesar, GetRawDeviceFeature espera a que el dispositivo responda antes de devolver un resultado, por lo que debe evitar llamarlo en subprocesos en los que el tiempo sea crítico, como el subproceso de representación o el de sondeo de entrada.

Microsoft::WRL::ComPtr<IGameInputRawDeviceReport> report;
if (SUCCEEDED(device->GetRawDeviceFeature(reportId, &report)))
{
    std::vector<uint8_t> data(report->GetRawDataSize());
    data.resize(report->GetRawData(data.size(), data.data()));
    // Parse the device-specific feature report data...
}

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

Historial de versiones

Versión	Cambios
v4	Se volvió a introducir.
v1	Se quitó.
v0	Se introdujo (sin implementar).

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::GetRawDeviceFeature (en desuso).

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

Sintaxis

Parámetros

Valor devuelto

Comentarios

Requisitos

Consulte también

Historial de versiones

Apéndice: Versiones anteriores

v0

​Sintaxis

​Parámetros

​Valor devuelto

​Comentarios

​Requisitos

​Consulte también

​Historial de versiones

​Apéndice: Versiones anteriores

​v0

Sintaxis

Parámetros

Valor devuelto

Comentarios

Requisitos

Consulte también

Historial de versiones

Apéndice: Versiones anteriores

v0