XtfGetConsoleInfoList
Devuelve un objetoXtfConsoleInfo que contiene información sobre una consola.
Sintaxis
Parámetros
addressTipo: 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 DevuelveS_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 punteroXtfConsoleInfo 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.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
XtfConsoleControlXBOX Tools Framework
