메인 콘텐츠로 건너뛰기
입력 장치의 플러그 앤 플레이(PnP) 장치 경로를 UTF-8 문자열로 가져옵니다.

구문

매개변수

bufferByteCount   _In_
형식: uint32_t
buffer가 가리키는 버퍼의 크기(바이트)입니다. 필요한 크기를 쿼리하려면 0을 전달하세요. buffer   _Out_writes_bytes_opt_(bufferByteCount)
형식: char*
null로 끝나는 UTF-8 PnP 경로를 받는 버퍼입니다. 필요한 크기를 쿼리하려면 nullptr을 전달하세요.

반환값

형식: uint32_t null 종결자를 포함하여 PnP 경로를 저장하는 데 필요한 버퍼의 크기(바이트)입니다.

설명

이 메서드는 buffer가 nullptr이 아니고 bufferByteCount가 필요한 크기 이상인 경우에만 buffer에 PnP 경로를 기록합니다. 그렇지 않으면 버퍼가 수정되지 않습니다. 경로를 검색하려면 bufferByteCount를 0으로, buffer를 nullptr로 지정하여 메서드를 한 번 호출해 필요한 크기를 가져오고, 해당 크기의 버퍼를 할당한 다음, 메서드를 다시 호출하세요. 장치에 PnP 경로가 없으면 필요한 크기는 1이며, 메서드는 빈 문자열을 기록합니다. PnP 경로를 사용하여 다른 API를 통해 기본 장치를 참조하세요. 경로는 UTF-8로 인코딩되어 있으므로 와이드 문자 문자열이 필요한 Windows API에 전달하기 전에 UTF-16으로 변환하세요(예: CP_UTF8과 함께 MultiByteToWideChar 사용). PnP 경로는 장치 개체의 수명 동안 변경되지 않습니다. 다음 예제는 장치의 PnP 경로를 검색합니다.
GameInput v3 이하에서는 IGameInputDevice::GetDeviceInfo가 반환하는 GameInputDeviceInfo 구조체의 pnpPath 멤버에서 이 정보를 얻을 수 있었습니다.

요구 사항

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

함께 보기

GameInput 개요
IGameInputDevice
IGameInputDevice::GetDisplayName
IGameInputDevice::GetContainerId

버전 기록

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