Sintaxe
Parâmetros
bufferByteCount _In_Tipo: uint32_t O tamanho, em bytes, do buffer apontado por buffer. Passe 0 para consultar o tamanho necessário. buffer _Out_writes_bytes_opt_(bufferByteCount)
Tipo: char* O buffer que recebe o nome de exibição UTF-8 terminado em nulo. Passe
nullptr para consultar o tamanho necessário.
Valor retornado
Tipo: uint32_t O tamanho, em bytes, do buffer necessário para armazenar o nome de exibição, incluindo o terminador nulo.Comentários
O método grava o nome de exibição em buffer somente se buffer não fornullptr e bufferByteCount for maior ou igual ao tamanho necessário. Caso contrário, o buffer não é modificado. Para recuperar o nome de exibição, chame o método uma vez com bufferByteCount igual a 0 e buffer igual a nullptr para obter o tamanho necessário, aloque um buffer desse tamanho e, em seguida, chame o método novamente.
Se o dispositivo não tiver um nome de exibição, o tamanho necessário será 1 e o método gravará uma cadeia de caracteres vazia.
O nome de exibição é um nome “amigável” para o dispositivo. Você pode exibi-lo na interface do usuário do seu aplicativo, mas não há garantia de que ele esteja localizado. O GameInput pesquisa essa cadeia de caracteres em vários locais, e um dos últimos fallbacks é o firmware do dispositivo.
O nome de exibição não muda durante o tempo de vida do objeto de dispositivo.
O exemplo a seguir recupera o nome de exibição de um dispositivo.
displayName da estrutura GameInputDeviceInfo retornada por IGameInputDevice::GetDeviceInfo.
Requisitos
Cabeçalho: GameInput.h Biblioteca: gameinput.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX SeriesConfira também
Visão geral do GameInputIGameInputDevice
IGameInputDevice::GetPnpPath
