Move all remaining kernel32 ctypes calls to winBindings

[michaelDCurran]

• Add all remaining winBindings.kernel32 definitions. Actual calls not replaced yet.
• Add all remaining required winBindings definitions for kernel32, and replace all raw ctypes calls. Also move some structures where required.

Link to issue number:

None.

Summary of the issue:

There are still many raw ctypes calls to kernel32 functions in the code base. These must be moved to winBindings, with correct definitions per Microsoft documentation to ensure accurate execution on 64 bit.

Description of user facing changes:

None.

Description of developer facing changes:

Description of development approach:

Add all required kernel32 definitions to winBindings, verifying each against Microsoft Documentation.
Replace the raw ctypes calls through out the code base with the winBindings definitions.
Any ctypes structures required by these definitions have also been moved to winBindings, and appropriate deprecation code added.

Testing strategy:

General smoke testing of an installed binary copy.

Known issues with pull request:

None known.

Code Review Checklist:

• Documentation:
  • Change log entry
  • User Documentation
  • Developer / Technical Documentation
  • Context sensitive help for GUI changes
• Testing:
  • Unit tests
  • System (end to end) tests
  • Manual testing
• UX of all users considered:
  • Speech
  • Braille
  • Low Vision
  • Different web browsers
  • Localization in other languages / culture than English
• API is compatible with existing add-ons.
• Security precautions taken.

[Copilot]

Pull Request Overview

This PR moves all remaining kernel32 ctypes calls to the winBindings module. The purpose is to replace raw ctypes calls to kernel32 with properly defined functions in winBindings.kernel32, ensuring correct execution on 64-bit systems and providing better type safety.

Key changes include:

• Adding comprehensive kernel32 function definitions to winBindings.kernel32
• Replacing raw ctypes calls throughout the codebase with winBindings equivalents
• Moving related structures (SYSTEMTIME, FILETIME, TIME_ZONE_INFORMATION, etc.) to winBindings.kernel32

Reviewed Changes

Copilot reviewed 30 out of 30 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
source/winBindings/kernel32.py	Adds hundreds of kernel32 function definitions with proper type annotations and documentation
source/winKernel.py	Replaces raw ctypes calls with winBindings equivalents and moves structures
source/languageHandler.py	Updates locale-related function calls to use winBindings
source/wincon.py	Replaces console API calls and moves structures
Various other files	Updates scattered kernel32 calls throughout the codebase

Comments suppressed due to low confidence (1)

source/winBindings/kernel32.py:1

• Extra space after 'PAPCFUNC' in the all tuple.

# A part of NonVisual Desktop Access (NVDA)

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[SaschaCowley]

Could you please also update changes.md? At present, the API changes I noted when reviewing were:

• appModuleHandler.processEntry32W -> winBindings.kernel32.PROCESSENTRY32
• winKernel.kernel32 -> winBindings.kernel32.dll
• winKernel.SYSTEMTIME -> winBindings.kernel32.SYSTEMTIME
• winKernel.FILETIME -> winBindings.kernel32.FILETIME
• winKernel.TIME_ZONE_INFORMATION -> winBindings.kernel32.TIME_ZONE_INFORMATION
• wincon.COORD -> winBindings.kernel32.COORD
• wincon.CONSOLE_SCREEN_BUFFER_INFO -> winBindings.kernel32.CONSOLE_SCREEN_BUFFER_INFO
• wincon.CONSOLE_SELECTION_INFO -> winBindings.kernel32.CONSOLE_SELECTION_INFO
• wincon.CHAR_INFO-> winBindings.kernel32.CHAR_INFO
• wincon.PHANDLER_ROUTINE -> winBindings.kernel32.PHANDLER_ROUTINE

[SaschaCowley]

A couple of small new things. Please note that the following comments remain unresolved:
source/winBindings/kernel32.py line 420
source/winBindings/kernel32.py line 455
source/wincon.py lines 11-14
source/wincon.py line 30