구문
매개변수
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은 이 문자열을 여러 위치에서 검색하며, 최종 폴백 중 하나는 장치의 펌웨어입니다.
표시 이름은 장치 개체의 수명 동안 변경되지 않습니다.
다음 예제는 장치의 표시 이름을 검색합니다.
displayName 멤버에서 이 정보를 얻을 수 있었습니다.
요구 사항
헤더: GameInput.h 라이브러리: gameinput.lib 지원되는 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔함께 보기
GameInput 개요IGameInputDevice
IGameInputDevice::GetPnpPath
