메인 콘텐츠로 건너뛰기
입력 장치의 친숙한 표시 이름을 UTF-8 문자열로 가져옵니다.

구문

매개변수

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

반환값

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

설명

이 메서드는 buffer가 nullptr이 아니고 bufferByteCount가 필요한 크기 이상인 경우에만 buffer에 표시 이름을 기록합니다. 그렇지 않으면 버퍼가 수정되지 않습니다. 표시 이름을 검색하려면 bufferByteCount를 0으로, buffer를 nullptr로 지정하여 메서드를 한 번 호출해 필요한 크기를 가져오고, 해당 크기의 버퍼를 할당한 다음, 메서드를 다시 호출하세요. 장치에 표시 이름이 없으면 필요한 크기는 1이며, 메서드는 빈 문자열을 기록합니다. 표시 이름은 장치의 “친숙한” 이름입니다. 애플리케이션의 UI에 표시할 수 있지만 현지화된다는 보장은 없습니다. GameInput은 이 문자열을 여러 위치에서 검색하며, 최종 폴백 중 하나는 장치의 펌웨어입니다. 표시 이름은 장치 개체의 수명 동안 변경되지 않습니다. 다음 예제는 장치의 표시 이름을 검색합니다.
GameInput v3 이하에서는 IGameInputDevice::GetDeviceInfo가 반환하는 GameInputDeviceInfo 구조체의 displayName 멤버에서 이 정보를 얻을 수 있었습니다.

요구 사항

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

함께 보기

GameInput 개요
IGameInputDevice
IGameInputDevice::GetPnpPath

버전 기록

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