Dispatchqueue and dispatchqueuecontroller

[avilev804]

Type of issue

Missing information

Feedback

I tried to create a dispatch queue controller on a dedicated thread in order to create a timer to tick once a second repetitively in order to update a swapchainpanel with graphics rendered using opengl. The documentation doesn't specify tha5 you need to call runeventloop on the qispatchqueue or the timer won't tick. Also creating the controller was a mess because the documentation doesn't specify how to create it and copilot doesn't do correctly and causes an exception to be thrown. Calling the helper function createdispatchqueuecontroller with a dispatchwueuecontroller.put() is wrong and access violation when using the queue to enquire the initial task to start the timer. Until I figured out that creating the controller using the Microsoft::ui::dispatch::createondedicatedthread() is the right way because it isn't documented properly.

Page URL

https://learn.microsoft.com/en-us/windows/apps/design/

Content source URL

https://github.com/MicrosoftDocs/windows-dev-docs/blob/docs/hub/apps/design/index.md

Author

Jim Walker (@jwmsft)

Document Id

fd60f56c-9371-b4a7-f274-8795605db089

[GrantMeStrength]

Thanks for the report. To route this to the right page, could you share a couple of details?

1. Which documentation page are you working from? A learn.microsoft.com URL for the article or API reference you followed would help us pinpoint what to update.
2. Which exact API and namespace are you using? For example, are you creating the controller with Microsoft.UI.Dispatching.DispatchQueueController.CreateOnDedicatedThread, and then calling DispatchQueueController.DispatchQueue and RunEventLoop from your dedicated thread?

With the specific page and the exact calls that failed (and the sequence that finally worked for you), we can correct the guidance so the dedicated-thread + RunEventLoop requirement is clearly documented. Leaving this open pending those details.