import brailleViewer

brailleViewer.destroyBrailleViewer()

app = wx.GetApp()

# prevent race condition with object deletion

# prevent deletion of the object while we work on it.

_SettingsDialog = settingsDialogs.SettingsDialog

nonWeak: typing.Dict[_SettingsDialog, _SettingsDialog] = dict(_SettingsDialog._instances)

for instance, state in nonWeak.items():

if state is _SettingsDialog.DialogState.DESTROYED:

log.error(

"Destroyed but not deleted instance of gui.SettingsDialog exists"

f": {instance.title} - {instance.__class__.__qualname__} - {instance}"

)

else:

log.debug("Exiting NVDA with an open settings dialog: {!r}".format(instance))

# wx.Windows destroy child Windows automatically but wx.Menu and TaskBarIcon don't inherit from wx.Window.

# They must be manually destroyed when exiting the app.

# Note: this doesn't consistently clean them from the tray and appears to be a wx issue. (#12286, #12238)

log.debug("destroying system tray icon and menu")

app.ScheduleForDestruction(mainFrame.sysTrayIcon.menu)

mainFrame.sysTrayIcon.RemoveIcon()

app.ScheduleForDestruction(mainFrame.sysTrayIcon)

log.debug(f"ending modal {window} during exit process")

log.debug("destroying main frame during exit process")

app.ScheduleForDestruction(window)

log.debug(f"closing window {window} during exit process")

global hasAppExited

hasAppExited = True

global mainFrame

# If MainLoop is terminated through WM_QUIT, such as starting an NVDA instance older than 2021.1,

# safeAppExit has not been called yet

if not hasAppExited:

safeAppExit()

wx.CallAfter(d.Destroy)

def safelyTerminateRunningNVDA(window: winUser.HWND):

winUser.PostSafeQuitMessage(window)

res = winKernel.waitForSingleObject(h, 6000) # give time to exit NVDA safely

else:

raise OSError("Failed to terminate with WM_EXIT_NVDA")

except OSError:

# allow for updating between NVDA versions, as NVDA <= 2020.4 does not accept WM_EXIT_NVDA messages

print("Failed to post a safe quit message across NVDA instances, sending WM_QUIT", file=sys.stderr)

res = _terminateRunningLegacyNVDA(window)

if res == 0:

# The process terminated within the timeout period.

return

def _terminateRunningLegacyNVDA(window: winUser.HWND) -> int:

'''

processID, _threadID = winUser.getWindowThreadProcessID(window)

winUser.PostMessage(window, winUser.WM_QUIT, 0, 0)

h = winKernel.openProcess(winKernel.SYNCHRONIZE, False, processID)

if not h:

# The process is already dead.

return 0

return winKernel.waitForSingleObject(h, 4000)

safelyTerminateRunningNVDA(oldAppWindowHandle)

except Exception as e:

print(f"Couldn't terminate existing NVDA process, abandoning start:\nException: {e}", file=sys.stderr)

if not ctypes.windll.user32.ChangeWindowMessageFilter(winUser.WM_QUIT, winUser.MSGFLT.ALLOW):

log.error("Unable to set the NVDA process to receive WM_QUIT messages from other processes")

raise winUser.WinError()

import enum

WM_DEVICECHANGE = 537

class MSGFLT(enum.IntEnum):

# Actions associated with ChangeWindowMessageFilterEx

# https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-changewindowmessagefilterex

# Adds the message to the filter. This has the effect of allowing the message to be received.

ALLOW = 1

# Removes the message from the filter. This has the effect of blocking the message.

DISALLOW = 2

# Resets the window message filter to the default.

# Any message allowed globally or process-wide will get through.

RESET = 0

WM_EXIT_NVDA = user32.RegisterWindowMessageW("WM_EXIT_NVDA")

if not WM_EXIT_NVDA:

winErr = WinError()

# provides additional information to the OSError based WinError

winErr.filename = "Failed to register Windows application message WM_EXIT_NVDA"

raise winErr

def PostSafeQuitMessage(hwnd: HWND):

"""

if not user32.PostMessageW(hwnd, WM_EXIT_NVDA, None, None):

raise WinError()

- Do not exit NVDA by sending a `WM_QUIT` message to the process. Instead send `winUser.WM_EXIT_NVDA` to the window handle (found by `winUser.FindWindow('wxWindowClassNR', 'NVDA')`). (#12286)