{"id":106350,"date":"2022-03-15T07:00:00","date_gmt":"2022-03-15T14:00:00","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/oldnewthing\/?p=106350"},"modified":"2023-11-12T17:21:43","modified_gmt":"2023-11-13T01:21:43","slug":"20220315-00","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20220315-00\/?p=106350","title":{"rendered":"Reducing chattiness by querying for multiple interfaces at once, part 1"},"content":{"rendered":"

During performance analysis, you may discover that your usage of a remote COM object is too chatty, meaning that too much time spent communicating back and forth at the expense of actual work. We saw some time ago how you can marshal a buffer by value instead of by reference<\/a>, so that there is only one round trip to the server to get the buffer.<\/p>\n

But maybe your chattiness problem is with the Query\u00adInterface<\/code> calls:<\/p>\n

\/\/ Error checking elided for expository purposes.\r\n\r\n\/\/ Create a widget.\r\nwil::com_ptr<IWidget> widget;\r\nCoCreateInstance(CLSID_Widget, nullptr,\r\n    CLSCTX_LOCAL_SERVER, IID_PPV_ARGS(&widget));\r\n\r\n\/\/ Set ourselves as its site.\r\nwil::com_ptr<IObjectWithSite> objectWithSite;\r\nwidget->QueryInterface(IID_PPV_ARGS(&objectWithSite));\r\nobjectWithSite->SetSite(this);\r\n\r\n\/\/ Load it from a file.\r\nwil::com_ptr<IPersistFile> persistFile;\r\nwidget->QueryInterface(IID_PPV_ARGS(&persistFile));\r\npersistFile->Load(fileName, STGM_READ);\r\n\r\n\/\/ Ready to do widget things.\r\nwidget->DoSomething();\r\n<\/pre>\n
Let’s count the number of calls to the server, and how many of them are performing actual work.<\/p>\n\n\n\n\n\n\n\n\n\n
Call<\/th>\nPurpose<\/th>\nNature<\/th>\n<\/tr>\n
Co\u00adCreate\u00adInstance<\/code><\/td>\nCreate the widget<\/td>\nReal work<\/td>\n<\/tr>\n
QueryInterface<\/code><\/td>\nGet the IObjectWithSite<\/code><\/td>\nBookkeeping<\/td>\n<\/tr>\n
SetSite<\/code><\/td>\nSet the site<\/td>\nConfiguration<\/td>\n<\/tr>\n
QueryInterface<\/code><\/td>\nGet the IPersistFile<\/code><\/td>\nBookkeeping<\/td>\n<\/tr>\n
Load<\/code><\/td>\nLoad the widget<\/td>\nInitialization<\/td>\n<\/tr>\n
DoSomething<\/code><\/td>\nDo something<\/td>\nActivity<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
There are six calls to the server, and a third of them are just bookkeeping.<\/p>\n
We can batch together the QueryInterface<\/code> by using IMultiQI<\/code>:<\/p>\n
\/\/ Error checking elided for expository purposes.\r\n\r\n\/\/ Create a widget.\r\nwil::com_ptr<IWidget> widget;\r\nCoCreateInstance(CLSID_Widget, nullptr,\r\n    CLSCTX_LOCAL_SERVER, IID_PPV_ARGS(&widget));\r\n\r\n\/\/ Get two interfaces with one call.                  <\/span>\r\nwil::com_ptr<IMultiQI> multiQI;                       <\/span>\r\nwidget->QueryInterface(IID_PPV_ARGS(&multiQI));       <\/span>\r\n\u00a0                                                     <\/span>\r\nMULTI_QI mqi[2] = {                                   <\/span>\r\n    { &__uuidof(IObjectWithSite), nullptr, 0 },       <\/span>\r\n    { &__uuidof(IPersistFile), nullptr, 0 },          <\/span>\r\n};                                                    <\/span>\r\nHRESULT hr = multiQI->QueryMultipleInterfaces(2, mqi);<\/span>\r\n\u00a0                                                     <\/span>\r\nwil::com_ptr<IObjectWithSite> objectWithSite;         <\/span>\r\nobjectWithSite.attach(mqi[0].pItf);                   <\/span>\r\n\u00a0                                                     <\/span>\r\nwil::com_ptr<IPersistFile> persistFile;               <\/span>\r\npersistFile.attach(mqi[1].pItf);                      <\/span>\r\n\u00a0                                                     <\/span>\r\nif (hr != S_OK) {                                     <\/span>\r\n    \/\/ Failed to get at least one interface.          <\/span>\r\n    return;                                           <\/span>\r\n}                                                     <\/span>\r\n\r\n\/\/ Set ourselves as its site.\r\nobjectWithSite->SetSite(this);\r\n\r\n\/\/ Load it from a file.\r\npersistFile->Load(fileName, STGM_READ);\r\n\r\n\/\/ Ready to do widget things.\r\nwidget->DoSomething();\r\n<\/pre>\n
We were able to combine the two Query\u00adInterface<\/code> calls into one by issuing a batch query. Note that the Query\u00adInterface<\/code> for IMultiQI<\/code> is not a server call: The IMultiQI<\/code> interface is implemented locally on the proxy.<\/p>\n
But wait, we can do even better: We can use Co\u00adCreate\u00adInstance\u00adEx<\/code> to obtain all thread interfaces as part of the initial creation:<\/p>\n
\/\/ Error checking elided for expository purposes.\r\n\r\n\/\/ Create a widget and request three interfaces.<\/span>\r\n\u00a0                                               <\/span>\r\nMULTI_QI mqi[3] = {                             <\/span>\r\n    { &__uuidof(IWidget), nullptr, 0 },         <\/span>\r\n    { &__uuidof(IObjectWithSite), nullptr, 0 }, <\/span>\r\n    { &__uuidof(IPersistFile), nullptr, 0 },    <\/span>\r\n};                                              <\/span>\r\nHRESULT hr = CoCreateInstanceEx(                <\/span>\r\n    CLSID_Widget, nullptr, CLSCTX_LOCAL_SERVER, <\/span>\r\n    nullptr, 3, mqi);                           <\/span>\r\n\u00a0                                               <\/span>\r\nwil::com_ptr<IWidget> widget;                   <\/span>\r\nwidget.attach(mqi[0].pItf);                     <\/span>\r\n\u00a0                                               <\/span>\r\nwil::com_ptr<IObjectWithSite> objectWithSite;   <\/span>\r\nobjectWithSite.attach(mqi[1].pItf);             <\/span>\r\n\u00a0                                               <\/span>\r\nwil::com_ptr<IPersistFile> persistFile;         <\/span>\r\npersistFile.attach(mqi[2].pItf);                <\/span>\r\n\u00a0                                               <\/span>\r\nif (hr != S_OK) {                               <\/span>\r\n    \/\/ Failed to get at least one interface.    <\/span>\r\n    return;                                     <\/span>\r\n}                                               <\/span>\r\n\r\n\/\/ Set ourselves as its site.\r\nobjectWithSite->SetSite(this);\r\n\r\n\/\/ Load it from a file.\r\npersistFile->Load(fileName, STGM_READ);\r\n\r\n\/\/ Ready to do widget things.\r\nwidget->DoSomething();\r\n<\/pre>\n
Now we have gotten rid of all of the bookkeeping calls.<\/p>\n\n\n\n\n\n\n\n
Call<\/th>\nPurpose<\/th>\nNature<\/th>\n<\/tr>\n
Co\u00adCreate\u00adInstance\u00adEx<\/code><\/td>\nCreate the widget and get interfaces<\/td>\nReal work<\/td>\n<\/tr>\n
SetSite<\/code><\/td>\nSet the site<\/td>\nConfiguration<\/td>\n<\/tr>\n
Load<\/code><\/td>\nLoad the widget<\/td>\nInitialization<\/td>\n<\/tr>\n
DoSomething<\/code><\/td>\nDo something<\/td>\nActivity<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Okay, so now we get to talk about error checking.<\/p>\n
There are three classes of results related to whether the interfaces could be obtained.<\/p>\n\n\n\n\n\n\n
Interfaces obtained<\/th>\nQueryMultipleInterfaces<\/th>\nCoCreateInstanceEx<\/th>\n<\/tr>\n
All<\/td>\nS_OK<\/code><\/td>\n<\/tr>\n
Some but not all<\/td>\nS_FALSE<\/code><\/td>\nCO_S_NOT\u00adALL\u00adINTERFACES<\/code><\/td>\n<\/tr>\n
None<\/td>\nError<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Note that for Co\u00adCreate\u00adInstance\u00adEx<\/code>, there are other errors possible to report any problems creating the object, but I’m looking at the interface-related errors.<\/p>\n
In our case, we need all of the interfaces, so anything that isn’t S_OK<\/code> is bad news, and we give up immediately.<\/p>\n
There may be other cases where you are probing for an interface and will take advantage of it if present, but its absence should not be considered a failure. In that case, you would dig into the MULTI_QI<\/code> to find out which interfaces could be obtained and which failed. You can use SUCCEEDED(hr)<\/code> as a shortcut to detect that something<\/i> was obtained.<\/p>\n
Note that in our sample code above, the obtained interfaces are immediately transferred to smart pointers so that they will be released properly, even in the case where not all interfaces were obtained.<\/p>\n
Now, it may be that the various calls to Query\u00adInterface<\/code> are scattered through the code, and it is unwieldy to query them at creation and then pass them around to all the places that query for them. We’ll look at that case next time.<\/p>\n
Bonus chatter<\/b>: Note that the batched interface query is a significant improvement only for remote objects. For local objects, calls to the object occur directly, so there’s no marshaling overhead. Furthermore, local objects are unlikely to support the IMulti\u00adQI<\/code> interface at all.<\/p>\n","protected":false},"excerpt":{"rendered":"
The multiple-query alternatives.<\/p>\n","protected":false},"author":1069,"featured_media":111744,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[25],"class_list":["post-106350","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code"],"acf":[],"blog_post_summary":"
The multiple-query alternatives.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/106350","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=106350"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/106350\/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=106350"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=106350"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=106350"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}