Skip to main content

XtfGetConsoleInfoList

Devuelve un objeto XtfConsoleInfo que contiene información sobre una consola.

Sintaxis

Parámetros

address
Tipo: PCWSTR
[in] La dirección de la consola. hConsoleInfo
Tipo: XtfConsoleInfo*
[out] Un puntero que se usa con la función XtfGetConsoleFieldValue para recuperar información sobre una consola.

Valor devuelto

Tipo: HRESULT Devuelve S_OK si la función se ejecutó correctamente y se puede usar XtfGetConsoleFieldValue para recuperar valores de hConsoleInfo; de lo contrario, devuelve un código de error HRESULT.

Comentarios

Para recuperar información sobre una consola, use primero esta función para obtener un puntero XtfConsoleInfo y, a continuación, use XtfGetConsoleFieldValue para recuperar información sobre la consola a partir de ese puntero. Después de recuperar la información que necesita, use XtfCloseConsoleInfoList para liberar los recursos asociados al puntero XtfConsoleInfo devuelto.
XtfGetConsoleInfoList recupera toda la información de la consola y proporciona un puntero a esa información. XtfGetConsoleFieldValue solo itera esa información recuperada. Debe usar ambas funciones juntas para recuperar información sobre una consola.
Si la consola de destino especificada en address para esta función no se ha aprovisionado, la función XtfGetConsoleFieldValue devuelve un valor vacío si se especifica XtfConsoleFieldId::DeviceID en field.
El siguiente ejemplo de código muestra cómo usar las funciones XtfGetConsoleInfoList y XtfGetConsoleFieldValue juntas para recuperar el identificador de consola de una consola de desarrollo.

Requisitos

Encabezado: xtfapi.h Biblioteca: XtfApi.lib Plataformas compatibles: Windows (para herramientas de consola XBOX)

Consulte también

XtfConsoleControl
XBOX Tools Framework
Última modificación el 28 de agosto de 2026