The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""Windows graphics adapters as DXGI reports them.
Task Manager's "GPU memory" for an adapter is DXGI's dedicated video memory plus shared system
memory, and that sum is what Windows lets the adapter allocate. An integrated GPU has almost no
dedicated memory, so its shared allowance is its real pool: an Intel Arc B390 on a 31.5 GB machine
gets 18 GB. Read through ctypes without environment-variable input or subprocesses.
"""
from __future__ import annotations
import ctypes
import functools
from contextlib import suppress
from ctypes import wintypes
from dataclasses import dataclass
_SOFTWARE_FLAG = 0x2 # DXGI_ADAPTER_FLAG_SOFTWARE (Microsoft Basic Render Driver)
_MAX_ADAPTERS = 16
# vtable slots: IUnknown::Release, IDXGIFactory1::EnumAdapters1, IDXGIAdapter1::GetDesc1.
_RELEASE, _ENUM_ADAPTERS1, _GET_DESC1 = 2, 12, 10
@dataclass(frozen=True)
class Adapter:
description: str
vendor_id: int
dedicated_bytes: int
shared_bytes: int
software: bool
@property
def memory_bytes(self) -> int:
"""What Windows lets this adapter allocate (Task Manager's GPU memory)."""
return self.dedicated_bytes + self.shared_bytes
class _Guid(ctypes.Structure):
_fields_ = [("Data1", wintypes.DWORD), ("Data2", wintypes.WORD), ("Data3", wintypes.WORD),
("Data4", ctypes.c_ubyte * 8)]
class _Luid(ctypes.Structure):
_fields_ = [("LowPart", wintypes.DWORD), ("HighPart", wintypes.LONG)]
class _AdapterDesc1(ctypes.Structure):
_fields_ = [("Description", ctypes.c_wchar * 128), ("VendorId", wintypes.UINT),
("DeviceId", wintypes.UINT), ("SubSysId", wintypes.UINT), ("Revision", wintypes.UINT),
("DedicatedVideoMemory", ctypes.c_size_t), ("DedicatedSystemMemory", ctypes.c_size_t),
("SharedSystemMemory", ctypes.c_size_t), ("AdapterLuid", _Luid), ("Flags", wintypes.UINT)]
_IID_DXGI_FACTORY1 = _Guid(0x770AAE78, 0xF26F, 0x4DBA, (ctypes.c_ubyte * 8)(0xA8, 0x29, 0x25, 0x3C, 0x83, 0xD1, 0xB3, 0x87))
def _method(obj: ctypes.c_void_p, slot: int, *argtypes):
vtable = ctypes.cast(obj, ctypes.POINTER(ctypes.POINTER(ctypes.c_void_p)))[0]
return ctypes.WINFUNCTYPE(ctypes.c_long, ctypes.c_void_p, *argtypes)(vtable[slot])
@functools.cache
def windows_gpu_adapters() -> tuple[Adapter, ...]:
"""Every adapter DXGI enumerates, in its order; empty off Windows or when DXGI can't answer."""
with suppress(OSError, AttributeError):
factory = ctypes.c_void_p()
if ctypes.WinDLL("dxgi").CreateDXGIFactory1(ctypes.byref(_IID_DXGI_FACTORY1), ctypes.byref(factory)) != 0:
return ()
found: list[Adapter] = []
try:
enum = _method(factory, _ENUM_ADAPTERS1, wintypes.UINT, ctypes.POINTER(ctypes.c_void_p))
for index in range(_MAX_ADAPTERS):
adapter = ctypes.c_void_p()
if enum(factory, index, ctypes.byref(adapter)) != 0: # DXGI_ERROR_NOT_FOUND ends the list
break
try:
desc = _AdapterDesc1()
if _method(adapter, _GET_DESC1, ctypes.POINTER(_AdapterDesc1))(adapter, ctypes.byref(desc)) == 0:
found.append(Adapter(desc.Description, desc.VendorId, desc.DedicatedVideoMemory,
desc.SharedSystemMemory, bool(desc.Flags & _SOFTWARE_FLAG)))
finally:
_method(adapter, _RELEASE)(adapter)
finally:
_method(factory, _RELEASE)(factory)
return tuple(found)
return ()