Skip to main content

XtfGetConsoleInfoList

本体に関する情報を含む XtfConsoleInfo オブジェクトを返します。

構文

パラメーター

address
型: PCWSTR
[in] 本体のアドレスです。 hConsoleInfo
型: XtfConsoleInfo*
[out] 本体に関する情報を取得するために XtfGetConsoleFieldValue 関数と共に使用するポインターです。

戻り値

型: HRESULT 関数が成功し、XtfGetConsoleFieldValue を使用して hConsoleInfo から値を取得できる場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

解説

本体に関する情報を取得するには、まずこの関数を使用して XtfConsoleInfo ポインターを取得し、次に XtfGetConsoleFieldValue を使用してそのポインターから本体に関する情報を取得します。 必要な情報を取得した後、XtfCloseConsoleInfoList を使用して、返された XtfConsoleInfo ポインターに関連付けられているリソースを解放します。
XtfGetConsoleInfoList は、本体からすべての情報を取得し、その情報へのポインターを提供します。 XtfGetConsoleFieldValue は、取得された情報を反復処理するだけです。 本体に関する情報を取得するには、両方の関数を一緒に使用する必要があります。
この関数の address で指定された対象の本体がプロビジョニングされていない場合、XtfGetConsoleFieldValue 関数は、fieldXtfConsoleFieldId::DeviceID が指定されている場合に空の値を返します。
次のコード サンプルは、開発本体のコンソール ID を取得するために XtfGetConsoleInfoList および XtfGetConsoleFieldValue 関数を一緒に使用する方法を示しています。

要件

ヘッダー: xtfapi.h ライブラリ: XtfApi.lib サポートされているプラットフォーム: Windows (XBOX 本体ツール用)

関連項目

XtfConsoleControl
XBOX Tools Framework
最終更新日 2026年8月24日