Pular para o conteúdo principal

XtfGetConsoleInfoList

Retorna um objeto XtfConsoleInfo que contém informações sobre um console.

Sintaxe

Parâmetros

address
Tipo: PCWSTR
[in] O endereço do console. hConsoleInfo
Tipo: XtfConsoleInfo*
[out] Um ponteiro a ser usado com a função XtfGetConsoleFieldValue para recuperar informações sobre um console.

Valor retornado

Tipo: HRESULT Retorna S_OK se a função tiver sido bem-sucedida e XtfGetConsoleFieldValue puder ser usada para recuperar valores de hConsoleInfo; caso contrário, retorna um código de erro HRESULT.

Comentários

Para recuperar informações sobre um console, primeiro use essa função para obter um ponteiro XtfConsoleInfo e, em seguida, use XtfGetConsoleFieldValue para recuperar informações sobre o console a partir desse ponteiro. Depois de recuperar as informações de que você precisa, use XtfCloseConsoleInfoList para liberar os recursos associados ao ponteiro XtfConsoleInfo retornado.
XtfGetConsoleInfoList recupera todas as informações do console e fornece um ponteiro para essas informações. XtfGetConsoleFieldValue apenas itera essas informações recuperadas. Você deve usar as duas funções em conjunto para recuperar informações sobre um console.
Se o console de destino especificado em address para essa função não tiver sido provisionado, a função XtfGetConsoleFieldValue retornará um valor vazio se XtfConsoleFieldId::DeviceID for especificado em field.
O exemplo de código a seguir demonstra como usar as funções XtfGetConsoleInfoList e XtfGetConsoleFieldValue em conjunto para recuperar a ID de console de um console de desenvolvimento.

Requisitos

Cabeçalho: xtfapi.h Biblioteca: XtfApi.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)

Confira também

XtfConsoleControl
XBOX Tools Framework
Última modificação em 6 de outubro de 2026