메인 콘텐츠로 건너뛰기
장치에 원시 기능 보고서를 보냅니다.

구문

매개변수

report   _In_
형식: IGameInputRawDeviceReport*
보낼 기능 보고서입니다. GameInputRawFeatureReport와 함께 CreateRawDeviceReport를 호출하여 보고서를 만들고, IGameInputRawDeviceReport::SetRawData를 호출하여 보고서를 채우세요.

반환값

형식: HRESULT 보고서가 장치에 제출되었으면 S_OK를 반환합니다. 장치가 집계 장치이면 GAMEINPUT_E_AGGREGATE_OPERATION_NOT_SUPPORTED를 반환하고, 보고서를 제출할 수 없으면 다른 오류 코드를 반환합니다.

설명

SetRawDeviceFeature 메서드는 장치에 기능 보고서를 기록합니다. 보고서 ID는 보고서의 GameInputRawDeviceReportInfo에서 가져오며, 페이로드는 IGameInputRawDeviceReport::SetRawData로 설정한 데이터입니다. 장치가 정의하는 기능 보고서와 각 보고서의 크기를 확인하려면 GetFeatureReportCount 및 GetFeatureReportInfo를 사용하세요. 현재 기능 보고서는 HID 장치에 대해 노출됩니다. HID 장치의 경우 보고서 데이터의 첫 번째 바이트가 보고서 ID입니다. SetRawDeviceFeature는 전달을 위해 보고서를 큐에 넣고 장치가 이를 처리할 때까지 기다리지 않고 반환합니다. 성공 반환값은 보고서가 제출되었다는 의미이며, 장치가 보고서를 수락했다는 의미는 아닙니다. 새 상태를 확인하려면 GetRawDeviceFeature를 호출하여 보고서를 다시 읽으세요.
GameInput API의 중급 및 고급 사용 사례는 고급 GameInput 항목을 참조하세요.

요구 사항

헤더: GameInput.h 라이브러리: gameinput.lib 지원되는 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

함께 보기

GameInput 개요
GetRawDeviceFeature
GetFeatureReportCount
GetFeatureReportInfo
CreateRawDeviceReport
IGameInputRawDeviceReport
IGameInputDevice

버전 기록

부록: 이전 버전

v0

GameInput v0에서는 이 메서드가 동일한 시그니처로 선언되었지만 구현되지 않았습니다. 자세한 내용은 IGameInputDevice::SetRawDeviceFeature(사용되지 않음)를 참조하세요.
마지막 수정일 2026년 11월 6일