XtfGetConsoleInfoList
本体に関する情報を含むXtfConsoleInfo オブジェクトを返します。
構文
パラメーター
address型: PCWSTR [in] 本体のアドレスです。 hConsoleInfo
型: XtfConsoleInfo* [out] 本体に関する情報を取得するために XtfGetConsoleFieldValue 関数と共に使用するポインターです。
戻り値
型: HRESULT 関数が成功し、XtfGetConsoleFieldValue を使用して hConsoleInfo から値を取得できる場合はS_OK を返します。それ以外の場合は HRESULT エラー コードを返します。
解説
本体に関する情報を取得するには、まずこの関数を使用してXtfConsoleInfo ポインターを取得し、次に XtfGetConsoleFieldValue を使用してそのポインターから本体に関する情報を取得します。 必要な情報を取得した後、XtfCloseConsoleInfoList を使用して、返された XtfConsoleInfo ポインターに関連付けられているリソースを解放します。
XtfGetConsoleInfoList は、本体からすべての情報を取得し、その情報へのポインターを提供します。 XtfGetConsoleFieldValue は、取得された情報を反復処理するだけです。 本体に関する情報を取得するには、両方の関数を一緒に使用する必要があります。この関数の
address で指定された対象の本体がプロビジョニングされていない場合、XtfGetConsoleFieldValue 関数は、field に XtfConsoleFieldId::DeviceID が指定されている場合に空の値を返します。XtfGetConsoleInfoList および XtfGetConsoleFieldValue 関数を一緒に使用する方法を示しています。
要件
ヘッダー: xtfapi.h ライブラリ: XtfApi.lib サポートされているプラットフォーム: Windows (XBOX 本体ツール用)関連項目
XtfConsoleControlXBOX Tools Framework
