XtfGetTitleOSState
取得執行中遊戲的相關資訊，包括其狀態、處理序識別碼、套件完整名稱和應用程式使用者模型識別碼 (AUMID)。語法
參數
address類型：PCWSTR [in] 主機的位址。 titleStateFlags
類型：UINT32* [out, optional] 旗標的位元 OR 組合，提供有關遊戲的其他資訊。如果不需要此值，請將其設定為
nullptr。此參數支援下列旗標：
pid
類型：UINT32* [out, optional] 如果遊戲目前正在執行，則為遊戲的處理序識別碼；否則為零。如果不需要此值，請將其設定為
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。
傳回值
類型：HRESULT 如果成功，則傳回S_OK；否則傳回 HRESULT 錯誤碼。如果 packageFullName 或 aumid 緩衝區太小，則傳回 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。
備註
此函式會傳回目前執行中遊戲的狀態資訊，包括遊戲狀態旗標、處理序識別碼、套件完整名稱和應用程式使用者模型識別碼 (AUMID)。如需封裝的詳細資訊，請參閱封裝。 若要擷取packageFullName 和 aumid 緩衝區所需的緩衝區長度，請執行下列步驟：
- 將
packageFullName和aumid參數設定為nullptr - 將
packageFullNameLength和aumidLength參數設定為有效的 UINT32 指標 - 呼叫
XtfGetTitleOSState
packageFullNameLength 和 aumidLength 參數會分別包含 packageFullName 和 aumidLength 所需的緩衝區長度 (以 WCHAR 為單位)。
需求
標頭： xtfapi.h 程式庫： XtfApi.lib 支援的平台： Windows (適用於 XBOX 主機工具)另請參閱
XtfGetAumidXtfGetPackageFullName
XTF 傳輸錯誤 (NDA 主題)
其他 Xtf API