Windhawk – Mod – Disable Virtual Desktop Transition Animation 修复版
在 Windhawk 里，Disable Virtual Desktop Transition Animation 这个 Mod 的核心作用，就是去掉虚拟桌面切换时的过渡动画。
原版逻辑很干脆：
直接绕过 SwitchDesktopWithAnimation，改为调用无动画的 SwitchDesktop。
大多数时候都没问题，但在某些场景下会出现一个小概率异常——切换间隔稍微快一点，就可能出现桌面没有真正跳转的情况。
修复方式
没有做复杂的状态判断，也没有引入额外同步逻辑。
采用的是一个简单直接的方案：
在 SwitchDesktopWithAnimation_hook 函数里增加一个 50ms 的延迟。
核心代码大概是这样：
HRESULT CVirtualDesktopManager__SwitchDesktopWithAnimation_hook(...)
{
Sleep(50);
return CVirtualDesktopManager__SwitchDesktop(...);
}
为什么加 50ms 就够了
这个延迟非常短，正常使用几乎感觉不到。
但它的作用很明确：
给系统内部流程留出一个极小的缓冲时间。
在某些情况下，桌面切换前会先触发鼠标悬停预览逻辑。
当动画被彻底移除后，这段时间窗口消失，新的切换请求可能会在预览流程尚未完全收尾时进入。
增加 50ms 延迟后：
- 悬停预览流程可以自然结束
- 内部状态完成更新
- 再执行真正的无动画切换
整个流程就稳定了。
实际效果
测试下来：
- 连续快速切换不会再丢失操作
- 不需要刻意放慢节奏
- 依旧保持无动画的即时体验
修改不复杂，但稳定性明显提升。
有时候问题不在于逻辑错误，而只是节奏太快。
稍微给系统一点时间，一切就顺畅了。
修复版完整代码
// ==WindhawkMod==
// @id disable-virtual-desktop-transition-fork
// @name Disable Virtual Desktop Transition Animation - 修复版
// @description Disables the animation when switching between virtual desktops on Windows 10 and Windows 11.
// @version 1.3
// @author Isabella Lulamoon (kawapure)
// @github https://github.com/kawapure
// @twitter https://twitter.com/kawaipure
// @homepage https://kawapure.github.io
// @include dwm.exe
// @include explorer.exe
// @architecture x86-64
// @compilerOptions -lkernel32 -lwevtapi -lshlwapi
// ==/WindhawkMod==
// ==WindhawkModReadme==
/*
# Disable Virtual Desktop Transition Animation
This mod disables the animation seen when switching between virtual desktops in Windows 10 and Windows 11.
## ⚠ Important usage note ⚠
In order to use this mod, you must allow Windhawk to inject into the **dwm.exe**
system process on Windows 10. To do so, add it to the process inclusion list in the advanced
settings. If you do not do this, it will silently fail to inject.
This step is only required for using this mod on Windows 10. It should work on Windows 11
without this step because they moved the animation to Explorer in Windows 11.
*/
// ==/WindhawkModReadme==
#include <libloaderapi.h>
#include <minwindef.h>
#include <windhawk_api.h>
#include <windhawk_utils.h>
#include <windows.h>
#include <winevt.h>
#include <processthreadsapi.h>
#include <shlwapi.h>
LPCWSTR g_kMsgBoxTitle = L"Disable Virtual Desktop Transition Animation (Windhawk mod)";
LPCWSTR g_kNoInjectDwmMsg =
L"DWM was unexpectedly restarted. The mod will not be reinjected to avoid a potential "
L"crash loop. Please disable and re-enable the mod to force reinjection.";
// 添加小延迟来解决快速点击问题
static const DWORD g_switchDelay = 50; // 切换前的延迟（毫秒）
class CVersionHelper
{
public:
// Data structure returned by GetVersionInfo().
struct VersionStruct
{
bool isInitialized = false;
DWORD dwMajorVersion = 0;
DWORD dwMinorVersion = 0;
DWORD dwBuildNumber = 0;
DWORD dwPlatformId = 0;
};
typedef void (WINAPI *RtlGetVersion_t)(OSVERSIONINFOEXW *);
// Gets the precise OS version.
static const VersionStruct *GetVersionInfo()
{
static VersionStruct s_versionStruct = { 0 };
// Skip if cached.
if (!s_versionStruct.isInitialized)
{
HMODULE hMod = LoadLibraryW(L"ntdll.dll");
if (hMod)
{
RtlGetVersion_t func = (RtlGetVersion_t)GetProcAddress(hMod, "RtlGetVersion");
if (!func)
{
FreeLibrary(hMod);
// TODO: error handling.
return &s_versionStruct;
}
OSVERSIONINFOEXW osVersionInfo = { 0 };
osVersionInfo.dwOSVersionInfoSize = sizeof(OSVERSIONINFOEXW);
func(&osVersionInfo);
s_versionStruct.dwBuildNumber = osVersionInfo.dwBuildNumber;
s_versionStruct.dwMajorVersion = osVersionInfo.dwMajorVersion;
s_versionStruct.dwMinorVersion = osVersionInfo.dwMinorVersion;
s_versionStruct.dwPlatformId = osVersionInfo.dwPlatformId;
s_versionStruct.isInitialized = true;
FreeLibrary(hMod);
}
}
return &s_versionStruct;
}
// Specific version helpers.
inline static bool IsWindows10OrGreater()
{
return GetVersionInfo()->dwMajorVersion >= 10 &&
GetVersionInfo()->dwBuildNumber >= 10240;
}
inline static bool IsWindows11OrGreater()
{
return GetVersionInfo()->dwMajorVersion >= 10 &&
GetVersionInfo()->dwBuildNumber >= 22000;
}
};
//=== WINDOWS 10 HOOKS ============================================================================
__declspec(noinline) HRESULT CVirtualDesktop__Initialize(void *pThis, void *a2)
{
// Failure result makes DWM reject the animation and move on like normal.
return E_FAIL;
}
size_t g_curVftableVirtualDesktopSwitch[18];
typedef void *(__cdecl *CVirtualDesktopSwitch__CVirtualDesktopSwitch_t)(void *pThis);
CVirtualDesktopSwitch__CVirtualDesktopSwitch_t CVirtualDesktopSwitch__CVirtualDesktopSwitch_orig;
void *__cdecl CVirtualDesktopSwitch__CVirtualDesktopSwitch_hook(void *pThis)
{
void *pAnim = CVirtualDesktopSwitch__CVirtualDesktopSwitch_orig(pThis);
Wh_Log(L"hi");
/*
* CVirtualDesktop inherits the Initialize() method from CStoryboard, so we need to
* create our own copy of the virtual function table to replace this with our own
* method.
*/
memcpy(g_curVftableVirtualDesktopSwitch, *(void **)pAnim, 18 * sizeof(size_t));
g_curVftableVirtualDesktopSwitch[1] = (size_t)CVirtualDesktop__Initialize;
*(void **)pAnim = (void *)g_curVftableVirtualDesktopSwitch;
return pAnim;
}
//=================================================================================================
bool HasDwminitWarningRecently()
{
const WCHAR* queryPath = L"Application";
const WCHAR* query =
L"*[System[Provider[@Name='Dwminit'] and (Level=3) and "
L"TimeCreated[timediff(@SystemTime) <= 10000]]]";
EVT_HANDLE queryHandle = EvtQuery(nullptr, // Local machine
queryPath, // Log path (Application log)
query, // Query
EvtQueryChannelPath // Query flags
);
if (!queryHandle)
{
Wh_Log(L"EvtQuery failed with error: %u", GetLastError());
return false;
}
bool found = false;
EVT_HANDLE eventHandle = nullptr;
DWORD dwReturned = 0;
constexpr DWORD kTimeout = 1000;
if (EvtNext(queryHandle, 1, &eventHandle, kTimeout, 0, &dwReturned))
{
found = true;
EvtClose(eventHandle);
}
else if (GetLastError() != ERROR_NO_MORE_ITEMS)
{
Wh_Log(L"EvtNext failed with error: %u", GetLastError());
}
EvtClose(queryHandle);
return found;
}
EXTERN_C void CALLBACK MsgDwmStartupReject()
{
MessageBoxW(
nullptr,
g_kNoInjectDwmMsg,
g_kMsgBoxTitle,
MB_OK
);
}
EXTERN_C void CALLBACK MsgWindowsVersionUnsupported()
{
MessageBoxW(
nullptr,
L"This mod does not support versions of Windows prior to Windows 10.",
g_kMsgBoxTitle,
MB_OK
);
}
EXTERN_C void CALLBACK MsgSymbolDownloadFailureUdwm()
{
MessageBoxW(
nullptr,
L"Failed to install symbol hooks for uDWM.dll. Symbols may not be available "
L"for your version of Windows yet, or there was likely an issue connecting to "
L"the internet.",
g_kMsgBoxTitle,
MB_OK
);
}
EXTERN_C void CALLBACK MsgSymbolDownloadFailureTwinuipcshell()
{
MessageBoxW(
nullptr,
L"Failed to install symbol hooks for TWinUI.PCShell.dll. Symbols may not be available "
L"for your version of Windows yet, or there was likely an issue connecting to "
L"the internet.",
g_kMsgBoxTitle,
MB_OK
);
}
BOOL Wh_ModInit();
/**
* Calling MessageBox during DWM startup can cause an infinite crash loop, so we have
* to defer execution into a separate process.
*
* Additionally, rundll32 can fail to work for a couple seconds after DWM starts up.
* I am not sure why this is, but in these cases, we need to additionally defer execution.
*
* For convenience, this behaviour is still used for displaying message boxes to the user
* when the mod is injected into Explorer on Windows 11.
*
* @param szProcedureName Name of the procedure in this module to execute.
* @param fDeferExec Defer execution via CMD
*/
void OpenSafeStartupMessageBox(LPCWSTR szProcedureName, bool fDeferExec = false)
{
WCHAR szParameters[1024];
WCHAR szPathSelf[MAX_PATH];
HMODULE hModuleSelf = nullptr;
if (!GetModuleHandleExW(
GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS | GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT,
(LPCWSTR)Wh_ModInit,
&hModuleSelf
))
{
return;
}
if (!GetModuleFileNameW(hModuleSelf, szPathSelf, sizeof(szPathSelf)))
{
return;
}
if (fDeferExec)
{
swprintf(szParameters, L"/k \"timeout 2 && rundll32.exe %s, %s && exit\"", szPathSelf, szProcedureName);
}
else
{
swprintf(szParameters, L"%s, %s", szPathSelf, szProcedureName);
}
ShellExecuteW(
nullptr,
L"open",
fDeferExec ? L"cmd.exe" : L"rundll32.exe",
szParameters,
nullptr,
SW_HIDE
);
}
bool InjectIntoDwm()
{
return !CVersionHelper::IsWindows11OrGreater() && CVersionHelper::IsWindows10OrGreater();
}
bool InjectIntoExplorer()
{
return CVersionHelper::IsWindows11OrGreater();
}
//=== WINDOWS 11 HOOKS ============================================================================
HRESULT (*CVirtualDesktopManager__SwitchDesktop)(void *pThis, struct IVirtualDesktop *pVirtualDesktop);
HRESULT (*CVirtualDesktopManager__SwitchDesktopWithAnimation_orig)(void *pThis, struct IVirtualDesktop *pVirtualDesktop);
HRESULT CVirtualDesktopManager__SwitchDesktopWithAnimation_hook(void *pThis, struct IVirtualDesktop *pVirtualDesktop)
{
// 添加小延迟确保预览操作完成（解决快速点击问题）
Sleep(g_switchDelay);
// 直接调用无动画切换
HRESULT hr = CVirtualDesktopManager__SwitchDesktop(pThis, pVirtualDesktop);
return hr;
}
// Whether or not we should lie about the user having animations enabled.
bool g_fLieAboutClientAreaAnimation = false;
// SPI hook to lie about client area animation.
using SystemParametersInfoW_t = decltype(&SystemParametersInfoW);
SystemParametersInfoW_t SystemParametersInfo_orig;
WINBOOL SystemParametersInfoW_hook(UINT uiAction,
UINT uiParam,
PVOID pvParam,
UINT fWinIni)
{
if (g_fLieAboutClientAreaAnimation && uiAction == SPI_GETCLIENTAREAANIMATION)
{
if (pvParam)
{
*(BOOL *)pvParam = FALSE;
}
return FALSE;
}
return SystemParametersInfo_orig(uiAction, uiParam, pvParam, fWinIni);
}
HRESULT (*CVirtualDesktopHotkeyHandler___CycleInDirection_orig)(void *pThis, int eDirection);
HRESULT CVirtualDesktopHotkeyHandler___CycleInDirection_hook(void *pThis, int eDirection)
{
g_fLieAboutClientAreaAnimation = true;
HRESULT hr = CVirtualDesktopHotkeyHandler___CycleInDirection_orig(pThis, eDirection);
g_fLieAboutClientAreaAnimation = false;
return hr;
}
//=================================================================================================
// The mod is being initialized, load settings, hook functions, and do other
// initialization stuff if required.
BOOL Wh_ModInit()
{
WCHAR szLoadedModule[MAX_PATH];
GetModuleFileNameW(GetModuleHandle(0), szLoadedModule, sizeof(szLoadedModule));
Wh_Log(L"Loaded into module: %s", szLoadedModule);
if (StrStrI(szLoadedModule, L"\\explorer.exe") != nullptr && InjectIntoDwm())
{
// We load into explorer.exe only on Windows 11 since the virtual desktop
// animation code was moved to TWinUI.PCShell and is hosted by the shell.
return FALSE;
}
else if (StrStrI(szLoadedModule, L"\\dwm.exe") != nullptr && InjectIntoExplorer())
{
// We load into dwm.exe in Windows 10, but not Windows 11.
return FALSE;
}
if (InjectIntoDwm() && HasDwminitWarningRecently())
{
Wh_Log(L"%s", g_kNoInjectDwmMsg);
OpenSafeStartupMessageBox(L"MsgDwmStartupReject", true);
return FALSE;
}
if (!CVersionHelper::IsWindows10OrGreater())
{
OpenSafeStartupMessageBox(L"MsgWindowsVersionUnsupported");
return FALSE;
}
Wh_Log(L"Init");
if (InjectIntoDwm())
{
// On Windows 10, we install hooks into uDWM.
WindhawkUtils::SYMBOL_HOOK udwmDllHooks[] = {
{
{
L"public: __cdecl CVirtualDesktopSwitch::CVirtualDesktopSwitch(void)"
},
(void **)&CVirtualDesktopSwitch__CVirtualDesktopSwitch_orig,
(void *)CVirtualDesktopSwitch__CVirtualDesktopSwitch_hook
}
};
if (!WindhawkUtils::HookSymbols(GetModuleHandleW(L"udwm.dll"), udwmDllHooks, ARRAYSIZE(udwmDllHooks)))
{
Wh_Log(L"Failed to successfully install all symbol hooks for uDWM.dll");
OpenSafeStartupMessageBox(L"MsgSymbolDownloadFailureUdwm");
return FALSE;
};
}
else if (InjectIntoExplorer())
{
// Hook SPI for convenience:
WindhawkUtils::Wh_SetFunctionHookT(
SystemParametersInfoW,
SystemParametersInfoW_hook,
&SystemParametersInfo_orig
);
// On Windows 11, we install hooks into TWinUI.PCShell.
// twinui.pcshell.dll
WindhawkUtils::SYMBOL_HOOK twinui_pcshellHooks[] = {
{
{
L"public: virtual long __cdecl CVirtualDesktopManager::SwitchDesktopWithAnimation(struct IVirtualDesktop *)"
},
(void **)&CVirtualDesktopManager__SwitchDesktopWithAnimation_orig,
(void *)CVirtualDesktopManager__SwitchDesktopWithAnimation_hook
},
{
{
L"public: virtual long __cdecl CVirtualDesktopManager::SwitchDesktop(struct IVirtualDesktop *)"
},
(void **)&CVirtualDesktopManager__SwitchDesktop
},
{
{
L"private: long __cdecl CVirtualDesktopHotkeyHandler::_CycleInDirection(enum VirtualDesktopSwitchDirection)"
},
(void **)&CVirtualDesktopHotkeyHandler___CycleInDirection_orig,
(void *)CVirtualDesktopHotkeyHandler___CycleInDirection_hook
},
};
if (!WindhawkUtils::HookSymbols(LoadLibraryW(L"twinui.pcshell.dll"), twinui_pcshellHooks, ARRAYSIZE(twinui_pcshellHooks)))
{
Wh_Log(L"Failed to successfully install all symbol hooks for TWinUI.PCShell.dll");
OpenSafeStartupMessageBox(L"MsgSymbolDownloadFailureTwinuipcshell");
return FALSE;
};
}
return TRUE;
}
// The mod is being unloaded, free all allocated resources.
void Wh_ModUninit()
{
Wh_Log(L"Uninit");
}
版权声明：
作者：Teroun
链接：https://blog.bingxs.com/windhawkmoddisablevirtualdesktoptransitionanimationfix.html
文章版权归作者所有，未经允许请勿转载。
THE END
