Document Windows architecture selection

Author: isVoid

cuda_pathfinder/cuda/pathfinder/_binaries/find_nvidia_binary_utility.py

@@ -183,6 +183,16 @@ def find_nvidia_binary_utility(utility_name: str) -> str | None:
         UnsupportedBinaryError: If ``utility_name`` is not in the supported set
             (see ``SUPPORTED_BINARY_UTILITIES``).
 
+    Windows on ARM (WoA) Note:
+        Binary utilities execute in separate processes and do not need to match
+        the Python process architecture. When choosing among architecture-specific
+        Windows layouts, this API deliberately targets the native machine
+        architecture rather than the Python interpreter architecture. For
+        example, standalone ``nsys`` and ``ncu`` discovery under x64 Python on an
+        Arm64 machine selects the Arm64 target. This differs from
+        ``load_nvidia_dynamic_lib`` and ``find_static_lib``, which target the
+        Python interpreter architecture.
+
     Search order:
         1. **NVIDIA Python wheels**
 

cuda_pathfinder/cuda/pathfinder/_dynamic_libs/load_nvidia_dynamic_lib.py

@@ -231,6 +231,15 @@ def load_nvidia_dynamic_lib(libname: str) -> LoadedDL:
         DynamicLibNotFoundError: If the library cannot be found or loaded.
         RuntimeError: If Python is not 64-bit.
 
+    Windows on ARM (WoA) Note:
+        On Windows, this API aims to load a dynamic library whose architecture
+        matches the Python interpreter architecture. For example, x64 Python
+        running on an Arm64 machine targets an x64 DLL, while native Arm64 Python
+        targets an Arm64 DLL. A library loaded into the Python process must be
+        compatible with that process. This differs from
+        ``find_nvidia_binary_utility``, which targets the native machine
+        architecture when selecting architecture-specific executables.
+
     Search order:
         0. **Already loaded in the current process**
 

cuda_pathfinder/cuda/pathfinder/_static_libs/find_static_lib.py

@@ -175,5 +175,13 @@ def find_static_lib(name: str) -> str:
     Raises:
         ValueError: If ``name`` is not a supported static library.
         StaticLibNotFoundError: If the static library cannot be found.
+
+    Windows on ARM (WoA) Note:
+        On Windows, this API aims to return the path to a static library whose
+        architecture matches the Python interpreter architecture. For example,
+        x64 Python running on an Arm64 machine targets the x64 library, while
+        native Arm64 Python targets the Arm64 library. This differs from
+        ``find_nvidia_binary_utility``, which targets the native machine
+        architecture when selecting architecture-specific executables.
     """
     return locate_static_lib(name).abs_path