구문
매개변수
reportId _In_형식: uint32_t 읽을 기능 보고서의 ID입니다. GetFeatureReportInfo가 반환하는 보고서 중 하나의
id 멤버와 일치해야 합니다.
report _COM_Outptr_형식: IGameInputRawDeviceReport** 장치에서 읽은 기능 보고서 데이터를 포함하는 새
IGameInputRawDeviceReport 개체를 받습니다. 실패하면 nullptr로 설정됩니다.
반환값
형식: HRESULT 성공하면S_OK를 반환합니다. 장치가 지정된 ID의 기능 보고서를 정의하지 않으면 E_NOTFOUND를 반환하고, 장치가 집계 장치이면 GAMEINPUT_E_AGGREGATE_OPERATION_NOT_SUPPORTED를 반환합니다. 장치에서 보고서를 읽을 수 없으면 다른 오류 코드를 반환합니다.
설명
GetRawDeviceFeature 메서드는 장치에 기능 보고서의 현재 내용을 요청하고 이를 새 IGameInputRawDeviceReport 개체로 반환합니다. 보고서의 GameInputRawDeviceReportInfo의 kind 멤버는 GameInputRawFeatureReport이며, 데이터 크기는 GetFeatureReportInfo가 반환하는 해당 요소의 size 멤버와 일치합니다. GetRawDataSize 및 IGameInputRawDeviceReport::GetRawData를 호출하여 데이터를 읽으세요.
장치가 정의하는 기능 보고서를 확인하려면 GetFeatureReportCount 및 GetFeatureReportInfo를 사용하세요. 현재 기능 보고서는 HID 장치에 대해 노출됩니다. HID 장치의 경우 보고서 데이터의 첫 번째 바이트가 보고서 ID입니다.
다른 원시 보고서 메서드와 달리 GetRawDeviceFeature는 반환하기 전에 장치의 응답을 기다리므로, 렌더링 스레드나 입력 폴링 스레드와 같이 시간이 중요한 스레드에서는 호출하지 마세요.
요구 사항
헤더: GameInput.h 라이브러리: gameinput.lib 지원되는 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔함께 보기
GameInput 개요SetRawDeviceFeature
GetFeatureReportCount
GetFeatureReportInfo
IGameInputRawDeviceReport
CreateRawDeviceReport
IGameInputDevice
