{"id":103171,"date":"2019-12-02T07:00:00","date_gmt":"2019-12-02T15:00:00","guid":{"rendered":"http:\/\/devblogs.microsoft.com\/oldnewthing\/?p=103171"},"modified":"2019-12-01T18:45:24","modified_gmt":"2019-12-02T02:45:24","slug":"20191202-00","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20191202-00\/?p=103171","title":{"rendered":"When should I use delayed-marshaling when creating an agile reference?"},"content":{"rendered":"

The Ro\u00adGet\u00adAgile\u00adReference<\/code> function lets you specify whether you want the marshaling of the wrapped object to take place eagerly or lazily.<\/p>\n\n\n\n\n\n
Flag<\/th>\nBehavior<\/th>\n<\/tr>\n
AGILE\u00adREFERENCE_<\/code>DEFAULT<\/code><\/td>\nEager marshaling<\/td>\n<\/tr>\n
AGILE\u00adREFERENCE_<\/code>DELAYED\u00adMARSHAL<\/code><\/td>\nLazy marshaling<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Why should you choose one over the other?<\/p>\n

It’s a question of whether you want to do a little work now in the hope of saving more work later.<\/p>\n

If you marshal eagerly, then at the point that the agile reference is created, it also gathers the information necessary to create a proxy later<\/a>. Later, if you use the agile reference from another thread, the agile reference uses that captured information to produce a proxy right then and there.<\/p>\n

If you marshal lazily, then at the point that the agile reference is created, it merely remembers the COM context that the agile reference was created in, which is a relatively fast operation. Later, if you use the agile reference from another thread, the agile reference first goes back to the COM context to capture the information necessary to create the proxy, and then it returns to the requesting thread and generates the proxy from that information.<\/p>\n\n\n\n\n\n\n\n
Action<\/th>\nEager marshal<\/th>\nLazy marshal<\/th>\n<\/tr>\n
Create agile reference<\/td>\nCreate information for proxy<\/td>\nCapture current COM context (fast)<\/td>\n<\/tr>\n
Use from same context<\/td>\nUse original object (fast)<\/td>\nUse original object (fast)<\/td>\n<\/tr>\n
Use from other context
\n(first time)<\/td>\n		Create proxy<\/td>\nCall into captured context
\nCreate information for proxy
\nReturn to original context
\nCreate proxy<\/td>\n<\/tr>\n
Use from other context
\n(second and subsequent times)<\/td>\n		Create proxy<\/td>\nCreate proxy<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Observe that if your intended operations are limited to the first two rows, then you’re better off doing lazy marshaling, since you avoid the Create information for proxy<\/i> step. But the penalty for guessing wrong is that when you use the agile reference from another context for the first time, you need to do extra work to get back to the original context in order to perform the Create information for proxy<\/i> step.<\/p>\n

On the other hand, if you know that you’re going to explore rows three and four, then you should do eager marshaling, because it’s less expensive to create the information for the proxy up front than on demand. The penalty for guessing wrong is that you went through the Create information for proxy<\/i> step unnecessarily.<\/p>\n

Notice that in both cases, it’s okay if you guess wrong. The operations will all still succeed. It’ll just be less efficient.<\/p>\n","protected":false},"excerpt":{"rendered":"

It’s a balance between doing more work now in anticipation of saving work later.<\/p>\n","protected":false},"author":1069,"featured_media":111744,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[25],"class_list":["post-103171","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code"],"acf":[],"blog_post_summary":"

It’s a balance between doing more work now in anticipation of saving work later.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/103171","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/users\/1069"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/comments?post=103171"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/103171\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media\/111744"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media?parent=103171"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=103171"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=103171"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}