Difference between revisions of "User:Petr-akhlamov/Compatibility mode"
(→Status) |
(Grammar fixes. Thanks for this precious article!) |
||
| Line 1: | Line 1: | ||
| − | Mark | + | Mark Jansen implements this function in ReactOS. |
==NT 6.0 API support== | ==NT 6.0 API support== | ||
| − | *{{JIRA|11288}} - Currently ReactOS targets only Windows 2003. Developer plans to implement a mechanism for user mode applications to be able to use APIs from Windows NT 6.0 and later, while still keeping the original 2k3 environment. | + | *{{JIRA|11288}} - Currently ReactOS targets only Windows Server 2003 SP2. Developer plans to implement a mechanism for user mode applications to be able to use APIs from Windows NT 6.0 and later, while still keeping the original 2k3 environment. |
**{{JIRA|11289}} - Research and document Windows compatibility settings | **{{JIRA|11289}} - Research and document Windows compatibility settings | ||
**{{JIRA|11290}} - Make sure the loader respects compatibility settings | **{{JIRA|11290}} - Make sure the loader respects compatibility settings | ||
| Line 10: | Line 10: | ||
{{JIRA|10366}} | {{JIRA|10366}} | ||
===NtApphelpCacheControl=== | ===NtApphelpCacheControl=== | ||
| − | '''NtApphelpCacheControl''' kernel function used by | + | '''NtApphelpCacheControl''' is a kernel function used by apphelp.dll to save 200 last run apps in RAM for faster search. After logging out, the list is saved in the registry, and loaded back when logging on. |
*<del>{{JIRA|9914}}</del> | *<del>{{JIRA|9914}}</del> | ||
| − | === | + | ===Implementing apphelp sdb layer=== |
| − | + | Implements most Sdb* API's that is related to reading and writing of Sdb files. | |
Sdb files are application compatibility databases, containing information about known bad applications, and a list of 'shims' to be applied to those applications. | Sdb files are application compatibility databases, containing information about known bad applications, and a list of 'shims' to be applied to those applications. | ||
| − | + | This is used as base: | |
| + | http://github.com/krofna/wine/tree/master/dlls/apphelp | ||
*<del>{{JIRA|10367}}</del> | *<del>{{JIRA|10367}}</del> | ||
| Line 24: | Line 25: | ||
===Tab in the explorer=== | ===Tab in the explorer=== | ||
| − | In newer | + | In newer Windows versions, this is implemented as shell extension (acppage.dll). It uses SetPermLayerState and SdbGetPermLayerKeys functions. |
| − | Now it's implemented with function which allows | + | Now it's implemented with a function which allows applying needed "layers". |
*<del>{{JIRA|10375}}</del> | *<del>{{JIRA|10375}}</del> | ||
| − | === | + | ===Integrating apphelp=== |
| − | + | Apphelp is integrated in <s>process creation (LDR)</s>, COM, msi and driver loading. | |
*{{JIRA|10368}} | *{{JIRA|10368}} | ||
| − | **03-06-2017 | + | **03-06-2017 Integration of apphelp in process creation was started <s>{{JIRA|13284}}</s> |
***June 27 first patch was published | ***June 27 first patch was published | ||
| − | ***June 29 function | + | ***June 29 SdbpMatchExe function was implemented |
| − | ***July 1 integration apphelp to process creation was implemented | + | ***July 1 integration of apphelp to process creation was implemented |
===Shim infrastructure=== | ===Shim infrastructure=== | ||
| − | It | + | It implements base infrastructure, so that shims can leverage to do their work. |
*{{JIRA|10370}} | *{{JIRA|10370}} | ||
| − | === | + | ===Providing default shims=== |
*{{JIRA|10369}} | *{{JIRA|10369}} | ||
| − | It | + | It provides: |
| − | *List of "emulated" OS | + | *List of "emulated" OS APIs. (<del>{{JIRA|11299}}</del>) |
*Resolution/Bitdepth/DisableThemes shims (<del>{{JIRA|11927}}</del>) | *Resolution/Bitdepth/DisableThemes shims (<del>{{JIRA|11927}}</del>) | ||
*IgnoreChromeSandbox {{JIRA|13409}} | *IgnoreChromeSandbox {{JIRA|13409}} | ||
| Line 51: | Line 52: | ||
===ShimLib=== | ===ShimLib=== | ||
*<s>{{JIRA|11329}}</s> | *<s>{{JIRA|11329}}</s> | ||
| − | + | ShimLib contains helper functions registering shims and handling common tasks. | |
First commit - [http://github.com/reactos/reactos/commit/3da415c457d68745c20dc32c6be37bfe8d83bfb1 r73461]. | First commit - [http://github.com/reactos/reactos/commit/3da415c457d68745c20dc32c6be37bfe8d83bfb1 r73461]. | ||
===Shim data in links=== | ===Shim data in links=== | ||
| − | + | Applies compatibility environment for shortcuts, and not *exe-file. | |
*{{JIRA|12678}} | *{{JIRA|12678}} | ||
==Status== | ==Status== | ||
| − | *05-09-2015 | + | *05-09-2015 '''NtApphelpCacheControl''' function [http://github.com/reactos/reactos/commit/2565dcba2634cdf76559f7e85fcf91596a1ba1cc was implemented] in the kernel (<del>{{JIRA|9914}}</del>) |
| − | *31-03-2016 | + | *31-03-2016 '''apphelp.dll''' library [http://github.com/reactos/reactos/commit/3a5f8b5d7eee1d38d1484a8033a6614399e6db08http://code.reactos.org/changelog/reactos?cs=71084 was added] (<del>{{JIRA|10367}}</del>) |
*28-05-2016 List of "emulated" API versions [http://github.com/reactos/reactos/commit/cc1a5a5932b1f599459948cdecd0214d010933ce was added] (<del>{{JIRA|11299}}</del>) | *28-05-2016 List of "emulated" API versions [http://github.com/reactos/reactos/commit/cc1a5a5932b1f599459948cdecd0214d010933ce was added] (<del>{{JIRA|11299}}</del>) | ||
| − | *16-12-2016 [http://github.com/reactos/reactos/commit/71d5b09683e6f97b36aa9fe4ae8c32345205770b | + | *16-12-2016 [http://github.com/reactos/reactos/commit/71d5b09683e6f97b36aa9fe4ae8c32345205770b Settings] for '''Resolution'''/'''Bitdepth'''/'''DisableThemes''' was added [http://github.com/reactos/reactos/commit/b7add401e93e88e15f10a0f3108ae93e35a26e72 1] [http://github.com/reactos/reactos/commit/f3f43843fe5a102367bd581b90f28323bf271ff3 2] (<del>{{JIRA|11927}}</del>) |
| − | *22-04-2017 - [http://github.com/reactos/reactos/commit/20756892b7414163fd56df7de1d70dbf42ff5257 | + | *22-04-2017 - [http://github.com/reactos/reactos/commit/20756892b7414163fd56df7de1d70dbf42ff5257 Implemented] custom compatibility mode selection as shell extension in '''acppage''' |
*19-05-2017 Initial implementation of integrate apphelp to process creation (LDR), COM, msi and Driver loading [http://github.com/reactos/reactos/commit/bbe72b0163cfee85b8cdd63f64b31fc459ccb26e was added] ({{JIRA|10368}}) | *19-05-2017 Initial implementation of integrate apphelp to process creation (LDR), COM, msi and Driver loading [http://github.com/reactos/reactos/commit/bbe72b0163cfee85b8cdd63f64b31fc459ccb26e was added] ({{JIRA|10368}}) | ||
| − | *29-06-2017 '''SdbpMatchExe''' function [http://github.com/reactos/reactos/commit/af9601337012b0e6338dec15bdad7bede9e6ef53 was implemented], | + | *29-06-2017 '''SdbpMatchExe''' function [http://github.com/reactos/reactos/commit/af9601337012b0e6338dec15bdad7bede9e6ef53 was implemented], that allows matching applications/files based on properties ({{JIRA|13284}}) |
*01-07-2017: | *01-07-2017: | ||
| − | ** | + | **Tab for explorer was [http://github.com/reactos/reactos/commit/1fa3c1a922e132061dda703b00cca986d8695271 fully implemented] |
| − | ** | + | **Most of the required functions are implemented, the rest will be implemented when they are needed |
| − | **[http://jira.reactos.org/browse/CORE-13284 | + | **[http://jira.reactos.org/browse/CORE-13284 Apphelp] [http://github.com/reactos/reactos/commit/711a1cb3414768c59419bb0454a1265403f7a5a6 was integrated] to create a process |
*30-07-2017 ShimLib implementation was finished | *30-07-2017 ShimLib implementation was finished | ||
| − | *17-08-2017 Compatibility mode [http://github.com/reactos/reactos/commit/9d8fe6f2381db5c877cc9d1858fae209bb77eb97 was enabled] default (but, | + | *17-08-2017 Compatibility mode [http://github.com/reactos/reactos/commit/9d8fe6f2381db5c877cc9d1858fae209bb77eb97 was enabled] default (but, it won't be able to be applied to system files - in '''system32''' and '''WinSxS''' folders) |
| − | *10-01-2018 [http://github.com/reactos/reactos/commit/63a3a2cbb8d67c1afe8b283880e75e0e5b5bed01 | + | *10-01-2018 [http://github.com/reactos/reactos/commit/63a3a2cbb8d67c1afe8b283880e75e0e5b5bed01 Beginnings] of support for [http://github.com/reactos/reactos/pull/273 NT6 applications] was implemented (details in [http://www.reactos.org/archives/public/ros-general/2018-January/002984.html mailing list]) (Colin Finck) |
==Compatibility apps== | ==Compatibility apps== | ||
| − | Apps, which | + | Apps, which are known to work in compatibility mode: |
*VMware Horizon Client for 32-bit Windows[http://github.com/reactos/reactos/commit/1eee5db1a53b0ff65a7bbe938d5be82f0aa7c845][http://vk.com/wall-1086956_45871] | *VMware Horizon Client for 32-bit Windows[http://github.com/reactos/reactos/commit/1eee5db1a53b0ff65a7bbe938d5be82f0aa7c845][http://vk.com/wall-1086956_45871] | ||
*Windows Media Player 6.4[http://vk.com/wall-1086956_50195] | *Windows Media Player 6.4[http://vk.com/wall-1086956_50195] | ||
| Line 84: | Line 85: | ||
==*_vista-libraries== | ==*_vista-libraries== | ||
| − | In ReactOS | + | In ReactOS there are some libraries such as advapi32_vista, kernel32_vista, ntoskrnl_vista and ntdll_vista. You can think that they are for the implementation of Vista+ APIa in ReactOS, but it's a mistake. For now these are present to provide needed functions for linking Wine's dlls which ReactOS uses. [http://reactos.org/forum/viewtopic.php?f=2&t=16678] |
==Links== | ==Links== | ||
*Discussion on the forum: [http://reactos.org/forum/viewtopic.php?f=2&t=14589], [http://reactos.org/forum/viewtopic.php?f=2&t=16621] | *Discussion on the forum: [http://reactos.org/forum/viewtopic.php?f=2&t=14589], [http://reactos.org/forum/viewtopic.php?f=2&t=16621] | ||
*[http://www.reactos.org/pipermail/ros-dev/2015-March/017216.html ReactOS versioning on mailing list] | *[http://www.reactos.org/pipermail/ros-dev/2015-March/017216.html ReactOS versioning on mailing list] | ||
| − | *[http://technet.microsoft.com/en-us/library/bb457032.aspx | + | *[http://technet.microsoft.com/en-us/library/bb457032.aspx Information about compatibility mode on the Microsoft site] |
| − | *[[User:Learn more/Appcompat| | + | *[[User:Learn more/Appcompat|Information about compatibility mode by developer]] |
Revision as of 09:00, 15 February 2018
Mark Jansen implements this function in ReactOS.
Contents
NT 6.0 API support
- CORE-11288 - Currently ReactOS targets only Windows Server 2003 SP2. Developer plans to implement a mechanism for user mode applications to be able to use APIs from Windows NT 6.0 and later, while still keeping the original 2k3 environment.
- CORE-11289 - Research and document Windows compatibility settings
- CORE-11290 - Make sure the loader respects compatibility settings
- CORE-11291 - Create Windows 7 spec files for core DLLs
- CORE-11292 - Core win32 API organization
- CORE-11293 - Research kernel requirements for NT 6+ user mode APIs
Compatibility mode implementation
NtApphelpCacheControl
NtApphelpCacheControl is a kernel function used by apphelp.dll to save 200 last run apps in RAM for faster search. After logging out, the list is saved in the registry, and loaded back when logging on.
Implementing apphelp sdb layer
Implements most Sdb* API's that is related to reading and writing of Sdb files.
Sdb files are application compatibility databases, containing information about known bad applications, and a list of 'shims' to be applied to those applications.
This is used as base: http://github.com/krofna/wine/tree/master/dlls/apphelp
Tab in the explorer
In newer Windows versions, this is implemented as shell extension (acppage.dll). It uses SetPermLayerState and SdbGetPermLayerKeys functions.
Now it's implemented with a function which allows applying needed "layers".
Integrating apphelp
Apphelp is integrated in process creation (LDR), COM, msi and driver loading.
- CORE-10368
- 03-06-2017 Integration of apphelp in process creation was started
CORE-13284- June 27 first patch was published
- June 29 SdbpMatchExe function was implemented
- July 1 integration of apphelp to process creation was implemented
- 03-06-2017 Integration of apphelp in process creation was started
Shim infrastructure
It implements base infrastructure, so that shims can leverage to do their work.
Providing default shims
It provides:
- List of "emulated" OS APIs. (
CORE-11299) - Resolution/Bitdepth/DisableThemes shims (
CORE-11927) - IgnoreChromeSandbox CORE-13409
- WindowProc exception handler CORE-12244
ShimLib
ShimLib contains helper functions registering shims and handling common tasks.
First commit - r73461.
Shim data in links
Applies compatibility environment for shortcuts, and not *exe-file.
Status
- 05-09-2015 NtApphelpCacheControl function was implemented in the kernel (
CORE-9914) - 31-03-2016 apphelp.dll library was added (
CORE-10367) - 28-05-2016 List of "emulated" API versions was added (
CORE-11299) - 16-12-2016 Settings for Resolution/Bitdepth/DisableThemes was added 1 2 (
CORE-11927) - 22-04-2017 - Implemented custom compatibility mode selection as shell extension in acppage
- 19-05-2017 Initial implementation of integrate apphelp to process creation (LDR), COM, msi and Driver loading was added (CORE-10368)
- 29-06-2017 SdbpMatchExe function was implemented, that allows matching applications/files based on properties (CORE-13284)
- 01-07-2017:
- Tab for explorer was fully implemented
- Most of the required functions are implemented, the rest will be implemented when they are needed
- Apphelp was integrated to create a process
- 30-07-2017 ShimLib implementation was finished
- 17-08-2017 Compatibility mode was enabled default (but, it won't be able to be applied to system files - in system32 and WinSxS folders)
- 10-01-2018 Beginnings of support for NT6 applications was implemented (details in mailing list) (Colin Finck)
Compatibility apps
Apps, which are known to work in compatibility mode:
- VMware Horizon Client for 32-bit Windows[1][2]
- Windows Media Player 6.4[3]
- Windows Media Player 7[4]
- Krita 3.2.1.0[5]
- QuickTime Player 7.7.9[6]
*_vista-libraries
In ReactOS there are some libraries such as advapi32_vista, kernel32_vista, ntoskrnl_vista and ntdll_vista. You can think that they are for the implementation of Vista+ APIa in ReactOS, but it's a mistake. For now these are present to provide needed functions for linking Wine's dlls which ReactOS uses. [7]
