WinRT Windows Devices Radios

Common errors

• ModuleNotFoundError: No module named 'winrt.windows.devices.radios'

  cause The `winrt-windows-devices-radios` package is not installed or the Python environment is incorrect.
  fix Run `pip install winrt-windows-devices-radios` to install the package in your active Python environment.

• RuntimeError: The current thread has no asyncio event loop.

  cause An `await` call was made outside of an `async` function, or an `async` function was called without `asyncio.run()` or a running event loop.
  fix Ensure all async WinRT operations are `await`ed inside `async` functions, and that your main function uses `asyncio.run(your_async_main_function())`.

• ImportError: DLL load failed while importing _winrt_windows_devices_radios: The specified module could not be found.

  cause This error typically occurs if a necessary Windows DLL (e.g., Visual C++ Redistributable, or a core Windows component) is missing, corrupted, or if the Python environment's architecture (32-bit vs. 64-bit) does not match the Windows installation, or if attempting to run on non-Windows.
  fix Verify you are on a compatible Windows OS. Ensure your Python installation matches your system architecture (usually 64-bit). Try reinstalling the `winrt-windows-devices-radios` package. Ensure relevant Windows system components are up to date.

Warnings

• breaking Version 3.0.0 introduced significant breaking changes, including a new `winrt.runtime` module, changes to boxing/unboxing functions, and how `winrt.system.Object` methods like `as_()` are used. Refer to the migration guide for details.
  Fix: Consult the `pywinrt` migration guide for updating code from v2.x to v3.x. Key changes include importing `box_value` from `winrt.system` and using `obj.as_(TargetType)`.
• gotcha This library is a projection of Windows Runtime (WinRT) APIs and is therefore strictly Windows-only. Attempting to install or run it on non-Windows operating systems will result in `ImportError` or `ModuleNotFoundError`.
  Fix: Ensure your development and deployment environment is running Windows. For cross-platform solutions, consider platform-agnostic alternatives.
• gotcha Many WinRT methods are asynchronous, indicated by names ending in `_async` (e.g., `get_radios_async`). These methods return `IAsyncOperation` or `IAsyncAction` objects and must be `await`ed within an `asyncio` event loop.
  Fix: Always use `await` with WinRT async methods and ensure your application runs within an `asyncio` event loop (e.g., by calling `asyncio.run()` for top-level async functions).

Install

• pip install winrt-windows-devices-radios Install specific package
• pip install pywinrt Install all WinRT packages

Imports

• Radio
  wrong:

  import winrt.windows.devices.radios.Radio

  correct:

  from winrt.windows.devices.radios import Radio

  WinRT types are typically imported directly from their module path.
• RadioState

  from winrt.windows.devices.radios import RadioState

Quickstart

This quickstart demonstrates how to enumerate available wireless radios (Wi-Fi, Bluetooth) and their current state using the WinRT API. It requires an `asyncio` event loop as most WinRT operations are asynchronous.

import asyncio
from winrt.windows.devices.radios import Radio, RadioState

async def list_radios():
    try:
        radios = await Radio.get_radios_async()
        if not radios:
            print("No radios found.")
            return

        print(f"Found {len(radios)} radios:")
        for radio in radios:
            print(f"  Name: {radio.name}")
            print(f"  Kind: {radio.kind}")
            print(f"  State: {radio.state}")
            # Example of setting state (requires appropriate user permissions)
            # if radio.state == RadioState.ON:
            #     print(f"  Attempting to turn OFF {radio.name}...")
            #     # await radio.set_state_async(RadioState.OFF)
            #     # print(f"  Turned OFF {radio.name}")

    except Exception as e:
        print(f"An error occurred: {e}")
        print("Ensure you are running on Windows with necessary permissions.")

if __name__ == "__main__":
    # os.environ.get('WINRT_DEBUG', 'false') # Example for auth check if needed
    asyncio.run(list_radios())