메인 콘텐츠로 건너뛰기
장치가 정의하는 원시 출력 보고서에 대한 설명을 검색합니다.

구문

매개변수

infoArrayCount   _In_
형식: uint32_t
infoArray의 요소 수입니다. 모든 출력 보고서를 검색하려면 GetOutputReportCount가 반환하는 값을 전달하세요. infoArray   _Out_writes_to_opt_(infoArrayCount, return)
형식: GameInputRawDeviceReportInfo*
출력 보고서당 하나의 구조체를 받는 배열에 대한 포인터입니다. nullptr일 수 있으며, 이 경우 아무것도 기록되지 않고 메서드는 0을 반환합니다.

반환값

형식: uint32_t infoArray에 기록된 요소 수입니다. infoArrayCount와 장치의 출력 보고서 수 중 작은 값이며, infoArray가 nullptr이거나 장치에 출력 보고서가 없으면 0입니다.

설명

각 요소는 kind 멤버가 GameInputRawOutputReport이고, id 멤버가 장치에서 정의한 보고서 ID이며, size 멤버가 보고서 데이터의 크기(바이트)인 GameInputRawDeviceReportInfo 구조체입니다. GetOutputReportCount를 호출하여 출력 보고서 수를 가져오고, 해당 크기의 배열을 할당한 다음, GetOutputReportInfo를 호출하여 배열을 채우세요. infoArrayCount가 출력 보고서 수보다 작으면 처음 infoArrayCount개의 요소만 기록됩니다. 장치의 출력 보고서는 장치가 연결되어 있는 동안 변경되지 않으므로 한 번 쿼리하고 결과를 캐시할 수 있습니다. 요소의 id 멤버를 GameInputRawOutputReport와 함께 CreateRawDeviceReport의 reportId 매개변수로 사용하여 SendRawDeviceOutput으로 보낼 수 있는 출력 보고서를 만드세요. size 멤버는 장치가 예상하는 보고서 데이터의 바이트 수를 제공합니다. 다음 예제는 장치의 출력 보고서를 검색하는 방법을 보여줍니다.
GameInput v3 이하에서는 IGameInputDevice::GetDeviceInfo가 반환하는 GameInputDeviceInfo 구조체의 outputReportInfo 멤버에서 이 정보를 얻을 수 있었습니다.

요구 사항

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

함께 보기

GameInput 개요
GetOutputReportCount
GameInputRawDeviceReportInfo
GameInputRawDeviceReportKind
IGameInputRawDeviceReport
CreateRawDeviceReport
SendRawDeviceOutput
고급 GameInput 항목
IGameInputDevice

버전 기록

마지막 수정일 2026년 11월 6일