XtfGetTitleOSState
実行中のゲームに関する情報 (状態、プロセス ID、パッケージのフル ネーム、アプリケーション ユーザー モデル ID (AUMID) など) を取得します。Syntax
Parameters
address型: PCWSTR [in] コンソールのアドレスです。 titleStateFlags
型: UINT32* [out, optional] ゲームに関する追加情報を提供するフラグのビット単位 OR の組み合わせです。この値が不要な場合は
nullptr に設定します。このパラメーターは次のフラグをサポートします。
pid
型: UINT32* [out, optional] ゲームが現在実行中の場合はそのゲームのプロセス ID、それ以外の場合はゼロです。この値が不要な場合は
nullptr に設定します。
packageFullName型: PWSTR [out, optional] ゲームが現在実行中の場合はそのゲームのパッケージのフル ネーム、それ以外の場合は空の文字列 ("") です。この値が不要な場合、またはバッファーの長さが必要な場合は
nullptr に設定します。
packageFullNameLength型: UINT32* [out, optional] packageFullName に必要なバッファーの長さ (WCHAR 単位) です。この値が不要な場合は
nullptr に設定します。
aumid型: PWSTR [out, optional] ゲームが現在実行中の場合はそのゲームの AUMID、それ以外の場合は空の文字列 ("") です。この値が不要な場合は
nullptr に設定します。
aumidLength型: UINT32* [out, optional] aumid に必要なバッファーの長さ (WCHAR 単位) です。この値が不要な場合は
nullptr に設定します。
Return value
型: HRESULT 成功した場合はS_OK を返します。それ以外の場合は、HRESULT エラー コードを返します。packageFullName または aumid のバッファーが小さすぎる場合は HRESULT_FROM_WIN32(ERROR_MORE_DATA) を返します。
Remarks
この関数は、現在実行中のゲームの状態に関する情報 (タイトル状態フラグ、プロセス ID、パッケージのフル ネーム、アプリケーション ユーザー モデル ID (AUMID) など) を返します。パッケージ化の詳細については、Packaging を参照してください。packageFullName と aumid のバッファーに必要な長さを取得するには、次の手順を実行します。
packageFullNameおよびaumidパラメーターをnullptrに設定しますpackageFullNameLengthおよびaumidLengthパラメーターを有効な UINT32 のポインターに設定しますXtfGetTitleOSStateを呼び出します
packageFullNameLength および aumidLength パラメーターには、それぞれ packageFullName および aumidLength に必要なバッファーの長さが WCHAR 単位で格納されます。
Requirements
ヘッダー: xtfapi.h ライブラリ: XtfApi.lib サポートされているプラットフォーム: Windows (XBOX コンソール ツール用)See also
XtfGetAumidXtfGetPackageFullName
XTF Transport Errors (NDA topic)
Additional Xtf APIs