app windows ui object windows object app code windows object

Windows Runtime internals: Understanding the threading modelMartyn LovellDevelopment Manager, Windows Runtime Experience4-107

Why threading mattersThe WinRT threading modelWhat’s behind the curtain

Agenda

www.buildwindows.com

Demo: Why threading matters

Why threads?

Service connected worldResponsive appsTouch-based experienceMany cores

How Windows parallelizes for you

Kernel threadsSeparate processesBrokersAsync operations

The view from the outside…

Windows threading modelUI objects live in a UI threadMain UI thread lasts as long as appMost other objects can be used on any threadWe pass out work to thread pool when needed

Windows threading model

Windows objects follow natural and familiar object rulesYou control lifetimeYou can use them on threads you take them toWhere you create them doesn’t constrain where you use or delete themOne of our biggest changes relative to COM

Threading

Windows UI

object

Main UI thread

Windows

object

Thread pool

App code App code App code

Windows

object

UI threads

User interface has special threading needsDon’t want OK to be pressed during OnCancel

UI objects are deliberately and naturally serializedDon’t do long running work on UI threadInstead, offload large work to thread pool with async object

Demo: UI Thread Behaviour

UI threads: reentrancy

Objects on UI threads generally don’t need locking to protect themselvesUI threads are not reentrant:When you make a call to another thread/process, only logically connected threads can call back to you

Desktop STA thread

Dispatch call 1

Single-threaded apartment reentrancy

Outgoing call

Processing input and calls

Dispatch call 2

Processing input and calls

ASTA thread

Dispatch call 1

Windows Store App STA – no reentrancy

Outgoing call

Outgoing callcompletes

Call 1 completes

Processing input and all calls

Processing input and related calls

ASTA thread

Dispatch call 1

Windows Store App STA – no reentrancy

Outgoing call

Outgoing call completes

Call 1 completes

Dispatch call 2Outgoing call

Call 2 completes

Related callback

Call 2 waiting

ASTA thread

Cross-ASTA deadlock prevention

ASTA thread

UI threads: reentrancy

UI threads can’t call each other directlyRejected at call time in Windows 8.1Use dispatcher or async object to avoidEnsures one UI thread can wait appropriately for the other to be readySee the MultipleViews sample for code showing how

UI threads: waiting

No long delays allowed on UI threadsMost classic waiting primitives are inappropriateWindows will terminate unresponsive apps

Instead, use UI-safe primitivesC#: awaitC++: create_taskJS: promise

Demo: Safe View Shutdown

Main UI thread

App primary UI always launched on main UI threadContract UI (e.g. Share) launched on separate UI thread

Main UI thread used for global stateOther UI threads for documents, contractsMain UI thread stays alive until app dies

HTML environment threading

All threads are UI threadsEven web workers are single-threaded entities

All events, completions delivered where they startedUse standard web app model APIs instead of WinRT Core*Underlying process has full WinRT features

XAML environment threading

XAML UI objects are thread-boundUse dispatcher to move UI work back to relevant UI threadWhole XAML tree must host on a single threadXAML events will be delivered on the UI threadAsync operations started on XAML threads have results delivered back on UI threadDirectX situation similar

What’s behind the curtain…

Objects and threading

Basic WinRT protocols are threading-agnosticIUnknown, IInspectable manages the object and its interfaces

WinRT protocols allow for some objects to have special threading requirementsWinRT captures all these concepts with marshaling

Marshaling

Marshaling allows an object to be used from another thread or process. Most WinRT objects do not require marshalingEven references to out-of-process objects (proxies) are agile in WinRTSo while marshaling still exists it is rarely visible – deliberately!

Marshaling

Objects decide how they are marshaledIMarshal, INoMarshal control marshaling

WinRT objects generally opt out of marshalingEither UI based or agile and thus not marshaled

All marshalers provided by the operating system with the help of MIDL-generated data

Marshaling

When will you need marshalingPassing types to UI threads – including dispatcher, JavaScriptTo make UI thread calls serialized, they must be queued and thus marshaled

If you define your own object and call from thread pool to UI, then you may need marshalingTo marshal, you need a proxy.

Thread pool threads

Where long-running work is doneAllocated, scaled and scheduled by the operating systemWinRT async operations automatically happen hereAlways initialized for WinRT usage when createdObjects may be called back on any thread

ASTA thread

Async object callbacks

Thread pool thread

Async op start

Real work

Async complete delivery

Projection returns to ASTA thread

Thread Pool thread

Async object callbacks

Thread pool thread

Async op start

Real work

Async complete delivery

Completion delivered where work was done

Agile objects

Agile objects are objects that can work in any thread of a process without being marshalledAgile objects can only store agile thingsNo storing bare IInspectablesIf passed an IInspectable, must wrap it in an agile reference

Agile objects

Agile objects are simple to deal withMost WinRT objects are agileOut-of-process proxies are agileAgile objects do not die if their original host thread dies

Agile references

When you get an IInspectable it may not be IAgileObjectIf it is not agile, may want to store an agile referenceNew for Windows 8.1: IAgileReference/RoGetAgileReferenceIf you are implementing an event source, you may need an array of agile references to event listeners

Apartments

Apartments are a COM concept that group and control thread and object lifetimesApartments exist in WinRT but have been made largely irrelevant by agility to reduce painThree types in Windows Store appsApplication single-threaded apartment (ASTA) – UI threadsMultithreaded apartment (MTA) – Thread poolNeutral threaded apartment (NTA) – Used by WinRT to help inter-process calls

Object lifetime & threads

Object lifetime in WinRT is simpleCOM would early-terminate objects, proxies, and agile references when apartment shut downWinRT makes most entities agile, lets you control lifetime

Cross-thread calling

WinRT calls delivered only when thread is readyCalls compete with other items for a thread’s attentionWindows 8.1 changesCalls no longer block input deliveryScheduler allows prioritization of work items

Summary

WinRT designed to make threading natural, simple, and familiarWe’ve drilled below what you need to knowKey design points are simpleUse async for long running operationsChoose agile objects for all except UIDon’t block the UI thread

See Talk 3-136 for async debugging support

Threading model registration

WinRT objects must register their threading typeIt indicates where an activation occurs:SingleThreaded (value == 1) means always in a UI thread MultiThreaded (value == 2) means always in the thread poolBoth (value == 0) means 'in the apartment of the caller'Both means a UI caller creates the object in the UI thread (direct call to activation) and a thread pool caller creates the object on the same thread in the poolThink: "apartment-local activation"Agile and Both can be inter-mixed and are a very common combination. This should be the default for all non-UI objects.

Languages and agility

OS objects are as described previouslyWhen you write WinRT objects:JavaScript objects are all single-threadC# objects are all agile• Unless they derive from non-agile basis like UI

C++ objects can be either agile or non-agile• Default depends on type of object• Compiler warns if you do the wrong thing with non-agile object

Thread-bound objects

A very small number non-UI WinRT objects are thread-boundOnce they are created on a thread, they can only be used thereAll should give clear and simple error when misused

Generally high context objects with expensive state or high responsivenessHandwriting recognitionImage codecsMedia

Normally each instance of the object can only perform one taskSo you just need to decide on which thread you want that to happen

Global state

Apps often need to store state that is shared between different viewsGlobal state should be stored as agile objects or agile referencesUse CoreApplication property storeEnsures easy access from any threadState lifetime ensured to match applicationWon’t cause another thread to stay alive

Test case where app is started by contract other than standard

Logical thread IDs

WinRT calls carry with them a logical thread IDRetained for all calls in a chain across threads, processesDifferent ID for unrelated operationsLogically-related calls are allowed to reenterEnsures an object can call back to you to get additional information

ASTA – no reentrancy

ASTA thread

Call 1 completes

Call 2 completes

Related callback

Call 2 waiting

Evaluate this session

Scan this QR code to evaluate this session and be automatically entered in a drawing to win a prize!

© 2013 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

app windows ui object windows object app code windows object

asta thread x x slide

related calls processing

calls dispatch

asta thread dispatch

calls related callback

desktop sta thread dispatch

Documents

up app to store(windows 8.1 và windows phone app)

windows store app html

wsdot.com · microsoft windows store app essentials with...

promise object in windows store app

windows 8 tablet app - geogebra.org · windows 8 tablet app...

windows 8 app development with windows azure

windows and windows mobile object api applications - sybase

windows p hone app developement

windows 10 app design

windows phone app studio.pdf

monetizing your windows phone app

allmyapps windows app store

windows phone app development

intro to windows app

windows 8 introduces “windows store,” microsoft’s app...

microsoft dynamics ax windows 8 app starter...

universal windows app 入門

windows app development

windows store app design (fitc)

windows 8 lob app deployment