Fixes compatibility issues with older games running on Windows 10 by wrapping DirectX dlls. Also allows loading custom libraries with the file extension .asi into game processes.
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
DDrawCompat Implement ddraw APIs: AttachedSurface, PrivateData, UniquenessValue, … Oct 14, 2018
DSoundCtrl Implement ddraw APIs: AttachedSurface, PrivateData, UniquenessValue, … Oct 14, 2018
Disasm Suppress compiler warnings Apr 25, 2018
Dllmain Implement AutoFrameSkip for dd7to9 Oct 31, 2018
DxWnd Simplify d3d8to9 integration Jan 27, 2018
External Move Hooking to submodule Oct 12, 2018
Libraries Minor reorg Oct 11, 2018
Logging Move Logging to submodule Oct 12, 2018
Resources Logged video card and added dxwnd binaries Feb 17, 2018
Settings Implement AutoFrameSkip for dd7to9 Oct 31, 2018
Stub Implement ddraw APIs: AttachedSurface, PrivateData, UniquenessValue, … Oct 14, 2018
Utils Move Hooking to submodule Oct 12, 2018
Wrappers Implement ddraw APIs: AttachedSurface, PrivateData, UniquenessValue, … Oct 14, 2018
d3d8 Implement ddraw APIs: AttachedSurface, PrivateData, UniquenessValue, … Oct 14, 2018
d3d9 Fix Ddraw Exclusive and Fullscreen Mode Oct 24, 2018
ddraw Implement AutoFrameSkip for dd7to9 Oct 31, 2018
.gitignore Update to Visual Studio 2017 Sep 21, 2018
.gitmodules Move Hooking to submodule Oct 12, 2018
License.txt Update copyright to 2018 Aug 18, 2018
README.md Implement ddraw APIs: AttachedSurface, PrivateData, UniquenessValue, … Oct 14, 2018
dxwrapper.sln Create wrapper stub and wrap more dlls Oct 2, 2017
dxwrapper.vcxproj Implement ddraw APIs: AttachedSurface, PrivateData, UniquenessValue, … Oct 14, 2018
dxwrapper.vcxproj.filters Implement ddraw APIs: AttachedSurface, PrivateData, UniquenessValue, … Oct 14, 2018

README.md

DxWrapper

Introduction

DxWrapper is a .dll file designed to wrap DirectX files to fix compatibility issues in older games. This project is primarily targeted at fixing issues with running games on Windows 10, by simply dropping .dll and .ini files into the game folder. Its secondary purpose is to offer a single tool combining several projects into one.

Features

DxWrapper has many features including:

  • Integration of DDrawCompat
  • Configuring DDrawCompat options to improve compatibility
  • Proxy for DxWnd
  • Conversion of DirectDraw 1-6 to DirectDraw 7
  • Conversion of Direct3D 1-6 to Direct3D 7
  • Conversion of Direct3D 8 (d3d8.dll) to Direct3D 9 (d3d9.dll) using d3d8to9
  • Tweaking of Microsoft DirectSound function calls using DSoundCtrl
  • ASI loader to load custom libraries with the file extension .asi into game processes using Ultimate ASI Loader
  • Supports being loaded as an ASI plug-in
  • Adding AntiAliasing support into DirectX 8 or 9 games even if the game does not support it (Windows 10 only)
  • Hot patch memory support (update game memory at run time, can be used to remove CD/DVD checks or resolve graphics or other glitches)
  • Set single CPU affinity (some games have issues with multi-core CPUs)
  • Disable display scaling on high DPI mode
  • Ability to set all 12 Application Compatibility Toolkit options for DXPrimaryEmulation using SetAppCompatData API
  • Set game window to fullscreen (some games have fullscreen issues)
  • Handling in-game exceptions or crashes
  • Load custom .dll files into games
  • Run custom processes at game start-up

Compatibility List for Games on Windows 10

So far I have tested this with over 70 games (that don't otherwise work correctly) to get them running on Windows 10. Most games will work, but some still have issues. Check out the Compatible Games wiki for a full list.

Installation

  1. Download the latest binary release from the repository's Release page and unzip it to a folder.
  2. Determine which .dll file is needed for the game. This depends on many factors which will be explained on page created later. Most commonly it is ddraw.dll, dsound.dll or winmm.dll.
  3. Copy this .dll file from the 'Stub' folder plus the dxwrapper.dll and dxwrapper.ini files into the game's installation directory, next to the main executable file. For some games the main executable is in a subdirectory (like 'Bin', 'Exe' or 'App') so the files will need to be copied it into that directory. Overwriting of any existing game files is not recommended.
  4. Open up the dxwrapper.ini file in a text editor and enable the settings needed for the game.

Do not attempt to overwrite any .dll in a Windows system directory as it is currently not supported and will not work.

Uninstallation

Delete the DxWrapper .dll and .ini files from the game's directory. You can also delete the log file, if there is one.

Configuration

To configure DxWrapper, edit the .ini file and enable the settings wanted. See the Configuration wiki for more details.

Supported DLLs

DxWrapper can wrap the following dlls:

  • bcrypt.dll
  • cryptsp.dll
  • d2d1.dll
  • d3d8.dll
  • d3d9.dll
  • d3d10.dll
  • d3d11.dll
  • d3d12.dll
  • dciman32.dll
  • ddraw.dll
  • dinput.dll
  • dinput8.dll
  • dplayx.dll
  • dsound.dll
  • msacm32.dll
  • msvfw32.dll
  • version.dll
  • wininet.dll
  • winmm.dll
  • winmmbase.dll

License

Copyright (C) 2018 Elisha Riedlinger

This software is provided 'as-is', without any express or implied warranty. In no event will the author(s) be held liable for any damages arising from the use of this software. Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
  2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
  3. This notice may not be removed or altered from any source distribution.

Credits

DxWrapper uses code from several other projects. So to give credit where credit is due, below is a list of locations that source code was taken from:

  • AppCompatData: Used comments from blitzbasic.com to build the feature to configure the DirectDraw AppCompatData settings.
  • Aqrit's ddwrapper: Includes code to read the ini config file.
  • d3d8to9: Includes the full Direct3D 8 to Direct3D 9 code.
  • D3DParseUnknownCommand: Includes code for DirectDraw D3DParseUnknownCommand from source code found in ReactOS.
  • DDrawCompat: Includes the full DDrawCompat v0.2.0b, v0.2.1 and Experimental version.
  • diablo-ddrawwrapper: Includes some code for converting ddraw to Direct3D.
  • DSoundCtrl: Includes the full DirectSoundControl code.
  • DxWnd: Includes code from DxWnd for API hooking, DxWnd proxy loading (init.cpp) and exception handling.
  • GetComputerManufacturer: Includes code from rohitab.com to get the computer vendor and model.
  • GetFileVersionInfo : Includes code from stackoverflow.com for getting the version of a PE file.
  • GetFunctionAddress: Includes code from rohitab.com to parse the PE export table.
  • MemoryModule: Includes code for loading libraries from memory.
  • OllyDbg: Includes the full cmdlist.c and disasm.c (disasm.dll) code used for exception handling.
  • SilentPatchFarCry: Includes code from SilentPatchFarCry to cache the clip plane in Direct3D 9.
  • Ultimate ASI Loader: Includes code for loading ASI plugins.
  • WineD3D d3d8.dll: Includes functions ValidatePixelShader and ValidateVertexShader.

Development

DxWrapper is written mostly in C++ using Microsoft Visual Studio Community 2017.

The project requires both the Windows 10 SDK and WDK. The exact version required can be seen in the project properties in Visual Studio.

Thanks for stopping by!