Microsoft.Xbox.Tools.ConsoleExtensions Namespace

The Devkit Console Extensions library (Microsoft.Xbox.Tools.ConsoleExtensions) allows you to write a shared resource app that installs packaged apps (and games), enumerates installed apps, launches installed apps, and performs network tracing and simulation. This library can be used on a Devkit (only on a Devkit) to write a custom app that can be used to install and launch your game when a DevPC is not attached to the console.

Note The Microsoft.Xbox.Tools.ConsoleExtensions namespace is designed to allow you to automate common developer console tasks such as installing your exclusive resource game. The full Microsoft.Xbox.Tools.ConsoleExtensions namespace is available to SRA apps as part of the ADK. A subset of the Microsoft.Xbox.Tools.ConsoleExtensions namespace is available to ERA apps as part of the XDK.

See the Console Extensions API overview for more information on setting up and using the console extensions API.

Classes

  Name Description
ApplicationInfo Contains the application user model ID (AUMID) and title ID for an application. [Available in ADK only]
ApplicationManager Contains methods for managing an application, including launching, stopping and uninstalling an application. [Available in ADK only]
PackageInfo Returned by ApplicationManager::GetInstalledPackages. Contains the display name, the package full name and the collection of applications associated with each package. [Available in ADK only]
PackageInstallManager Provides methods for starting and monitoring package installations. [Available in ADK only]
PackageInstallResult Contains information on the completion an install operation. [Available in ADK only]
SimulationManager Contains methods for starting and stopping simulations and for getting the status of simulations that are currently running. [Available in ADK and XDK]
SimulationNetworkChannelProfile  
TraceManager Contains methods for starting and stopping traces. [Available in ADK and XDK]
TraceResult Returned by TraceManager::StopAsync. Contains information on the completion of a trace. [Available in ADK and XDK]

Structures

  Name Description
PackageInstallProgress Contains information on the progress of an installation. [Available in ADK only]
SimulationStatus Contains information on the status of a simulation. Returned from SimulationManager::GetStatusAsync. [Available in ADK and XDK]

Enumerations

  Name Description
InstallationStage Indicates the stage of the current package installation. [Available in ADK only]
SimulationManagerNetworkProtocol Specifies the protocol family for ports being exempted from simulation.
SimulationProfile Indicates the network profile to be simulated. [Available in ADK and XDK]
SimulationType Indicates the type of simulation. Values from this enum are passed to SimulationManager::StartAsync to indicate the type of simulation to start. The SimulationStatus structures returned from SimulationManager::GetStatusAsync include a field whose type is SimulationType. This field indicates the type of simulation that is running. [Available in ADK and XDK]
TraceType Indicates the type of trace. Values from this enum are passed to TraceManager::StartAsync to indicate the type of trace to start. Currently the only valid value is NetworkPacket. [Available in ADK and XDK]

See also

Console Extensions API