跳轉到主要內容

XtfGetConsoleInfoList

傳回包含主機相關資訊的 XtfConsoleInfo 物件。

語法

參數

address
類型:PCWSTR
[in] 主機的位址。 hConsoleInfo
類型:XtfConsoleInfo*
[out] 與 XtfGetConsoleFieldValue 函式搭配使用以擷取主機相關資訊的指標。

傳回值

類型:HRESULT 如果函式成功,且可以使用 XtfGetConsoleFieldValue 從 hConsoleInfo 擷取值,則傳回 S_OK;否則傳回 HRESULT 錯誤碼。

備註

若要擷取主機的相關資訊,請先使用此函式取得 XtfConsoleInfo 指標,然後使用 XtfGetConsoleFieldValue 從該指標擷取主機的相關資訊。擷取所需的資訊之後,請使用 XtfCloseConsoleInfoList 釋放與傳回之 XtfConsoleInfo 指標相關聯的資源。
XtfGetConsoleInfoList 會從主機擷取所有資訊,並提供指向該資訊的指標。XtfGetConsoleFieldValue 只會逐一查看所擷取的資訊。您必須同時使用這兩個函式,才能擷取主機的相關資訊。
如果在此函式的 address 中指定的目標主機尚未佈建,則當 field 中指定 XtfConsoleFieldId::DeviceID 時,XtfGetConsoleFieldValue 函式會傳回空值。
下列程式碼範例示範如何同時使用 XtfGetConsoleInfoList 與 XtfGetConsoleFieldValue 函式來擷取開發主機的主機識別碼。

需求

標頭: xtfapi.h 程式庫: XtfApi.lib 支援的平台: Windows (適用於 XBOX 主機工具)

另請參閱

XtfConsoleControl
XBOX Tools Framework
最後修改於 2026年10月6日