> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Additional Xtf APIs (API contents)

> Additional Xtf APIs

The XBOX Tools Framework (XTF) API is used for checking available space for apps and retrieving user friendly error messages.

## App functions

| App function | Description |
| - | - |
| [XtfPullAuditionApp](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfpullauditionapp-xtfapi-xbox-windows-m.md) | Reserved for internal use. |
| [XtfPullRegisterApp](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfpullregisterapp-xtfapi-xbox-windows-m.md) | Reserved for internal use. |
| [XtfPullSupplyMock](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfpullsupplymock-xtfapi-xbox-windows-m.md) | Reserved for internal use. |
| [XtfPullUnregisterApp](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfpullunregisterapp-xtfapi-xbox-windows-m.md) | Reserved for internal use. |

## Console info functions

| Console info function | Description |
| - | - |
| [XtfCloseConsoleInfoList](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfcloseconsoleinfolist-xbox-microsoft-m.md) | Frees resources associated with an **XtfConsoleInfo** object returned by XtfGetConsoleInfoList. |
| [XtfGetAvailableSpaceForAppInstallation](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/functions/xtfgetavailablespaceforappinstallation-xtfconsolecontrol-xbox-microsoft-m.md) | Gets the total number of bytes available on the specified storage device of a development console. |
| [XtfGetConsoleFieldValue](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetconsolefieldvalue-xbox-microsoft-m.md) | Retrieves information about a console, one of Tools IP Address, Console IP Address, AccessKey, Console ID, HostName, Device ID, DevKit Cert type, SystemMajorVersion, SystemMinorVersion, SystemBuildVersion, or SystemRevisionVersion. |
| [XtfGetConsoleInfoList](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/functions/xtfgetconsoleinfolist-xtfconsolecontrol-xbox-microsoft-m.md) | Returns an `XtfConsoleInfo` object that contains information about a console. |
| [XtfGetSavedConsoleAddress](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetsavedconsoleaddress-xtfapi-xbox-windows-m.md) | Gets the Tools IP address of the default console for XBOX Tools Framework (XTF) apps. |
| [XtfGetSystemUpTime](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetsystemuptime-xtfapi-xbox-windows-m.md) | Gets the amount of time in milliseconds that the System OS and Game OS have been running. |
| [XtfWaitForConsoleOSReady](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfwaitforconsoleosready-xtfapi-xbox-windows-m.md) | Waits until the console OS is ready to receive commands before returning. |
| [XtfWaitForConsoleState](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfwaitforconsolestate.md) | Blocks execution until either the specified console states are reached or a timeout occurs. |

## Credential functions

| Credential function | Description |
| - | - |
| [XtfAddCredential](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfaddcredential-xtfapi-xbox-windows-m.md) | Adds credentials (user name and password) to the given console for use by Run from PC Deployment. |
| [XtfCloseCredentialInfoList](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfclosecredentialinfo-xtfapi-xbox-windows-m.md) | Frees resources associated with an XtfNetworkCredentials object returned by XtfGetCredentialInfoList. |
| [XtfGetCredentialInfoCount](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfocount-xtfapi-xbox-windows-m.md) | Gets the count of credentials stored in an `XtfNetworkCredentials` object returned by [XtfGetCredentialInfoList](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md). |
| [XtfGetCredentialInfoList](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md) | Returns an `XtfNetworkCredentials` object that contains the list of credentials currently stored on the console. |
| [XtfGetCredentialServerName](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetcredentialtargetname-xtfapi-xbox-windows-m.md) | Gets the server name part of the credentials stored at an index in an XtfNetworkCredentials object returned by XtfGetCredentialInfoList. |
| [XtfGetCredentialUserName](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetcredentialusername-xtfapi-xbox-windows-m.md) | Gets the user name part of the credentials stored at an index in an XtfNetworkCredentials object returned by XtfGetCredentialInfoList. |
| [XtfRemoveCredential](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfremovecredential-xtfapi-xbox-windows-m.md) | Removes credentials from the given console. Use XtfAddCredential add credentials. |

## Debug functions

| Debug function | Description |
| - | - |
| [XtfCaptureOutputBegin](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m.md) | Starts capture of debug output. |
| [XtfCaptureOutputEnd](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputend-xtfapi-xbox-windows-m.md) | Stop capture debug output. |
| [XtfDebugStringCallback](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfdebugstringcallback-xtfapi-xbox-windows-m.md) | Callback invoked for each output debug string captured by [XtfCaptureOutputBegin](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m.md). |
| [XtfDebugStringErrorCallback](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfdebugstringerrorcallback-xtfapi-xbox-windows-m.md) | Callback invoked for each error captured by [XtfCaptureOutputBegin](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m.md). |
| [XtfGetErrorText](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/functions/xtfgeterrortext-xtfconsolecontrol-xbox-microsoft-m.md) | Gets a user-friendly error message and action text for the specified `HRESULT`. |

## Game clip functions

| Game clip function | Description |
| - | - |
| [XtfCaptureRecordedGameClip](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfcapturegameclip-xbox-microsoft-m.md) | Captures a video clip from the currently running game. |

## Package info functions

| Package info function | Description |
| - | - |
| [XtfClosePackageInfo](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfclosepackageinfo-xtfapi-xbox-windows-m.md) | Frees a package information object. |
| [XtfGetAumid](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m.md) | Gets the application model user ID at an index from a package information object. |
| [XtfGetCountofAppUserModelIds](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m.md) | Gets the count of application user model IDs from a package information object. |
| [XtfGetPackageFullName](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md) | Get the full package name from a package information object. |
| [XtfRegisterAllPackagesOnDrive](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfregisterallpackagesondrive-xtfapi-xbox-windows-m.md) | Register all packages deployed on the specified drive. |
| [XtfRegisterNetworkSharePackage](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md) | Registers a package for Run from PC Deployment. |
| [XtfRegisterPackage](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md) | Registers a package deployed to the title scratch drive. |
| [XtfRegisterPackageOnDrive](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfregisterpackageondrive-xtfapi-xbox-windows-m.md) | Registers a package deployed on the specified drive. |
| [XtfUnregisterPackage](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfunregisterpackage-xtfapi-xbox-windows-m.md) | Unregisters a package deployed to the title scratch drive. |

## Title OS functions

| Title OS function | Description |
| - | - |
| [XtfCacheTitleOS](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfcachetitleos-xtfapi-xbox-windows-m.md) | Adds a Game OS to the OS cache. |
| [XtfGetCachedTitleOSVersions](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md) | Gets the version information of each Game OS cached on the console. |
| [XtfGetCachedTitleOSVersionsCallback](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversionscallback-xtfapi-xbox-windows-m.md) | Callback invoked for each Game OS found by [XtfGetCachedTitleOSVersions](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetcachedtitleosversions-xtfapi-xbox-windows-m.md). |
| [XtfGetTitleOSFourPartVersion](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md) | Gets version information about the Game OS for the currently running title. |
| [XtfGetTitleOSState](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgettitleosstate-xtfapi-xbox-windows-m.md) | Query the state of the Title OS, Fast Iteration Mode, running Title, associate PID, and Package information. |
| [XtfGetTitleProcessMemoryReports](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgettitleprocessmemoryreports-xtfapi-xbox-windows-m.md) | Reserved for internal use. |
| [XtfRemoveTitleOSFromCache](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcache-xtfapi-xbox-windows-m.md) | Removes a Game OS from the cache on the console. |
| [XtfRemoveTitleOSFromCacheByVersion](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcachebyversion-xtfapi-xbox-windows-m.md) | Removes the Game OS matching the specified [FourPartVersion](https://docs.xbox.com/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md) from the cache on the console. |
| [XtfShutdownTitleOS](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfshutdowntitleos-xtfapi-xbox-windows-m.md) | Shuts down the active title and Game OS. |
| [XtfStartTitleOS](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md) | Starts or restarts the specified Game OS. |
| [XtfStartTitleOSByGameConfig](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbygameconfig-xtfapi-xbox-windows-m.md) | Starts or restarts the Game OS based on the contents of a MicrosoftGame.config file that is stored in memory as a string. |
| [XtfStartTitleOSByVersion](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m.md) | Starts or restarts the Game OS matching the specified [FourPartVersion](https://docs.xbox.com/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md) from the cache on the console. |

## Overlay Folder functions

| Overlay Folder function | Description |
| - | - |
| [XtfClearAllOverlayFolders](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md) | Clears the Overlay Folder paths for all packages installed/registered on the console. |
| [XtfGetOverlayFolder](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m.md) | Gets the Overlay Folder path for a specified package. |
| [XtfSetOverlayFolder](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m.md) | Sets the Overlay Folder path for a specified package. |

## Structures

| Structure | Description |
| - | - |
| [FourPartVersion](https://docs.xbox.com/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md) | The four-part version number of a Game OS. |

## Enumerations

| Enumeration | Description |
| - | - |
| [XtfConsoleCertType Enumeration](https://docs.xbox.com/reference/tools/xtf/xtfapi/enums/xtfconsolecerttype-xbox-windows-t.md) | Reserved for internal use. |
| [XtfConsoleFieldId Enumeration](https://docs.xbox.com/reference/tools/xtf/xtfapi/enums/xtfconsolefieldid-xbox-windows-t.md) | Identifies the value to return from [XtfGetConsoleFieldValue](https://docs.xbox.com/reference/tools/xtf/xtfapi/functions/xtfgetconsolefieldvalue-xbox-microsoft-m.md). |
| [XtfConsoleFieldType Enumeration](https://docs.xbox.com/reference/tools/xtf/xtfapi/enums/xtfconsolefieldtype-xbox-windows-t.md) | Identifies the type of the value returned from XtfGetConsoleFieldValue. |


## Related topics

- [XtfFileIO (API contents)](https://docs.xbox.com/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n.md)
- [XtfApplication (API contents)](https://docs.xbox.com/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n.md)
- [XtfInput (API contents)](https://docs.xbox.com/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n.md)
- [XtfUser (API contents)](https://docs.xbox.com/reference/tools/xtf/xtfuser/xtfuser-xbox-windows-n.md)
- [XtfConsoleControl (API contents)](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)
