Windows.ApplicationModel.Calls Windows.ApplicationModel.Calls Windows.ApplicationModel.Calls Windows.ApplicationModel.Calls Namespace

Controls multiple aspects of how an application on the phone behaves, including lock-screen interaction, the phone call history, and various telephony options and information.


CallAnswerEventArgs CallAnswerEventArgs CallAnswerEventArgs CallAnswerEventArgs

Supports the AnswerRequested event of the VoipPhoneCall class.

CallRejectEventArgs CallRejectEventArgs CallRejectEventArgs CallRejectEventArgs

Supports the RejectRequested event of the VoipPhoneCall class.

CallStateChangeEventArgs CallStateChangeEventArgs CallStateChangeEventArgs CallStateChangeEventArgs

Supports the EndRequested, HoldRequested, and ResumeRequested events of the VoipPhoneCall class.

LockScreenCallEndCallDeferral LockScreenCallEndCallDeferral LockScreenCallEndCallDeferral LockScreenCallEndCallDeferral

The LockScreenCallEndCallDeferral object signals when the app no longer needs to defer the removal of itself from the lock screen.

LockScreenCallEndRequestedEventArgs LockScreenCallEndRequestedEventArgs LockScreenCallEndRequestedEventArgs LockScreenCallEndRequestedEventArgs

Controls the removal of an app from the lock screen.

LockScreenCallUI LockScreenCallUI LockScreenCallUI LockScreenCallUI

Handles communication to and from the lock screen.

MuteChangeEventArgs MuteChangeEventArgs MuteChangeEventArgs MuteChangeEventArgs

Supports the NotifyMuted and NotifyUnmuted events.

PhoneCallBlocking PhoneCallBlocking PhoneCallBlocking PhoneCallBlocking

Controls the blocking of phone numbers as they are received.

PhoneCallHistoryEntry PhoneCallHistoryEntry PhoneCallHistoryEntry PhoneCallHistoryEntry

A collection of information about a phone call for the call history.

PhoneCallHistoryEntryAddress PhoneCallHistoryEntryAddress PhoneCallHistoryEntryAddress PhoneCallHistoryEntryAddress

Address book information for a contact used by PhoneCallHistoryEntry objects.

PhoneCallHistoryEntryQueryOptions PhoneCallHistoryEntryQueryOptions PhoneCallHistoryEntryQueryOptions PhoneCallHistoryEntryQueryOptions

Options for querying the phone call entries.

PhoneCallHistoryEntryReader PhoneCallHistoryEntryReader PhoneCallHistoryEntryReader PhoneCallHistoryEntryReader

Enables the calling app to read through the phone call history entries.

PhoneCallHistoryManager PhoneCallHistoryManager PhoneCallHistoryManager PhoneCallHistoryManager

Provides APIs for the application to get access to the PhoneCallHistoryStore.

PhoneCallHistoryManagerForUser PhoneCallHistoryManagerForUser PhoneCallHistoryManagerForUser PhoneCallHistoryManagerForUser

Provides APIs for the application to get access to the PhoneCallHistoryStore for a specific user.

PhoneCallHistoryStore PhoneCallHistoryStore PhoneCallHistoryStore PhoneCallHistoryStore

A collection of phone call history entries.

PhoneCallManager PhoneCallManager PhoneCallManager PhoneCallManager

Provides the ability to query the call status and launch phone calls.

PhoneCallStore PhoneCallStore PhoneCallStore PhoneCallStore

Represents a collection of information about the phone lines available on a device.

PhoneCallVideoCapabilities PhoneCallVideoCapabilities PhoneCallVideoCapabilities PhoneCallVideoCapabilities

Provides access to the video call capabilities for a PhoneLine instance.

PhoneCallVideoCapabilitiesManager PhoneCallVideoCapabilitiesManager PhoneCallVideoCapabilitiesManager PhoneCallVideoCapabilitiesManager

Enables an application to get the PhoneCallVideoCapabilities for a PhoneLine instance.

PhoneDialOptions PhoneDialOptions PhoneDialOptions PhoneDialOptions

Represents options for dialing a call.

PhoneLine PhoneLine PhoneLine PhoneLine

Represents a phone line.

PhoneLineCellularDetails PhoneLineCellularDetails PhoneLineCellularDetails PhoneLineCellularDetails

Provides detailed interaction with the cellular components of a phone line.

PhoneLineConfiguration PhoneLineConfiguration PhoneLineConfiguration PhoneLineConfiguration

A collection of properties providing information about a phone line.

PhoneLineWatcher PhoneLineWatcher PhoneLineWatcher PhoneLineWatcher

Represents a class that monitors for new/removed/updated phone lines on the device and notifies listeners about any changes.

PhoneLineWatcherEventArgs PhoneLineWatcherEventArgs PhoneLineWatcherEventArgs PhoneLineWatcherEventArgs

Represents a class that contains the information about which phone line was added, removed, or updated.

PhoneVoicemail PhoneVoicemail PhoneVoicemail PhoneVoicemail

Represents the voice mail data associated with a PhoneLine instance.

VoipCallCoordinator VoipCallCoordinator VoipCallCoordinator VoipCallCoordinator

Allows an application to manage VoIP calls.

VoipPhoneCall VoipPhoneCall VoipPhoneCall VoipPhoneCall

Represents a VoIP phone call.


CellularDtmfMode CellularDtmfMode CellularDtmfMode CellularDtmfMode

Indicates the type of dual tone multi-frequency (DTMF) used by a cellular phone.

PhoneAudioRoutingEndpoint PhoneAudioRoutingEndpoint PhoneAudioRoutingEndpoint PhoneAudioRoutingEndpoint

The available audio endpoints you can use for dialing a phone call.

PhoneCallHistoryEntryMedia PhoneCallHistoryEntryMedia PhoneCallHistoryEntryMedia PhoneCallHistoryEntryMedia

The type of media associated with a call.

PhoneCallHistoryEntryOtherAppReadAccess PhoneCallHistoryEntryOtherAppReadAccess PhoneCallHistoryEntryOtherAppReadAccess PhoneCallHistoryEntryOtherAppReadAccess

The level of read access provided to other applications.

PhoneCallHistoryEntryQueryDesiredMedia PhoneCallHistoryEntryQueryDesiredMedia PhoneCallHistoryEntryQueryDesiredMedia PhoneCallHistoryEntryQueryDesiredMedia

A filter used to retrieve call entries based on the contained media.

PhoneCallHistoryEntryRawAddressKind PhoneCallHistoryEntryRawAddressKind PhoneCallHistoryEntryRawAddressKind PhoneCallHistoryEntryRawAddressKind

The type of address used by the PhoneCallHistoryEntryAddress.

PhoneCallHistorySourceIdKind PhoneCallHistorySourceIdKind PhoneCallHistorySourceIdKind PhoneCallHistorySourceIdKind

The type of identifier that the PhoneCallHistoryEntry.SourceId refers to.

PhoneCallHistoryStoreAccessType PhoneCallHistoryStoreAccessType PhoneCallHistoryStoreAccessType PhoneCallHistoryStoreAccessType

The type of store you want to retrieve.

PhoneCallMedia PhoneCallMedia PhoneCallMedia PhoneCallMedia

The types of media available in a phone call.

PhoneLineNetworkOperatorDisplayTextLocation PhoneLineNetworkOperatorDisplayTextLocation PhoneLineNetworkOperatorDisplayTextLocation PhoneLineNetworkOperatorDisplayTextLocation

The possible locations for displaying network operator information to the user.

PhoneLineTransport PhoneLineTransport PhoneLineTransport PhoneLineTransport

The transport used by a particular phone line.

PhoneLineWatcherStatus PhoneLineWatcherStatus PhoneLineWatcherStatus PhoneLineWatcherStatus

The current status of the PhoneLineWatcher.

PhoneNetworkState PhoneNetworkState PhoneNetworkState PhoneNetworkState

Describes the network registration status of a phone line.

PhoneSimState PhoneSimState PhoneSimState PhoneSimState

The current state of the SIM card for a cellular phone line.

PhoneVoicemailType PhoneVoicemailType PhoneVoicemailType PhoneVoicemailType

The type of voice mail associated with a PhoneLine instance.

VoipPhoneCallMedia VoipPhoneCallMedia VoipPhoneCallMedia VoipPhoneCallMedia

Specifies the media types used by a VoIP call.

VoipPhoneCallRejectReason VoipPhoneCallRejectReason VoipPhoneCallRejectReason VoipPhoneCallRejectReason

Specifies the reason that an incoming call was rejected.

VoipPhoneCallResourceReservationStatus VoipPhoneCallResourceReservationStatus VoipPhoneCallResourceReservationStatus VoipPhoneCallResourceReservationStatus

Indicates the result of attempting to reserve VoIP resources.

VoipPhoneCallState VoipPhoneCallState VoipPhoneCallState VoipPhoneCallState

Specifies the state of a VoIP call.


This namespace is divided into three primary categories of classes and enumerations. These categories are the lock screen, the phone call history, and the telephony options and information.

The lock-screen-call contract lets an app, with user consent, perform these tasks:

  • Raise a notification toast with up to three additional buttons: Accept with Video, Accept with Audio, Ignore.
  • If the notification toast appears on the lock screen and the user chooses to accept the call, the app displays its call UI directly on the lock screen without requiring the user to unlock.

The telephony options and information classes use the CallsPhoneContract. In order to use these classes, you will need to declare the phoneCall capability in your manifest.


If your application uses the phoneCall capability, you must request a waiver if you want to publish your application in China. Contact your premier support representative if you need the waiver.

An example that demonstrates how to use much of the functionality of the Windows.ApplicationModel.Calls API can be found here.

See Also