Clarify usage of virtual terminal mode flags

[clinton-r]

Hi, I'd like to suggest a few improvements for this page. I learned in the reply here that the ENABLE_PROCESSED_OUTPUT flag should usually be kept enabled when using ENABLE_VIRTUAL_TERMINAL_PROCESSING, even if disabling all the flags that are normally enabled for "cooked" mode. I think I would find it more clear if you mentioned that, both in your discussion at the top of the page about "raw" and "cooked" modes, and in the descriptions of the ENABLE_PROCESSED_OUTPUT and ENABLE_VIRTUAL_TERMINAL_PROCESSING flags.

(Does it still count as "raw" mode if I ENABLE_VIRTUAL_TERMINAL_PROCESSING?)

It might make sense to include a few examples of common scenarios and the flags that would be used in each of them.

Also, in the description of the ENABLE_MOUSE_INPUT flag you mention that the mouse events won't be seen by ReadFile() or ReadConsole() - I think it would be good if you also mentioned a function that could be used to get the mouse events.

Thanks

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 7b1efe45-1da7-8a45-83fd-e89ab594d2ac
• Version Independent ID: 141f4082-dc42-3bb6-ef44-3a536bfdbaa0
• Content: High-Level Console Modes - Windows Console
• Content Source: docs/high-level-console-modes.md
• Product: console
• GitHub Login: @miniksa
• Microsoft Alias: miniksa

[DHowett]

So, the terms "raw" and "cooked" only really apply to the input handle. It looks like an oversight that we implicate any output modes when talking about what is raw vs. what is cooked. 😄

[pizzaz93]

When ENABLE_MOUSE_INPUT is set is there a way/function to read the mouse events of mouse movement and button presses from the input buffer?

[DHowett]

When ENABLE_MOUSE_INPUT is set is there a way/function to read the mouse events of mouse movement and button presses from the input buffer?

When ENABLE_MOUSE_INPUT is set, an application must use ReadConsoleInput and look for MOUSE_EVENT input records.

[pizzaz93]

I incorporated this guidance into the above PR.