Python3用ctypes调用NvAPI报错：找不到NvAPI_Initialize函数如何解决？

尝试用Python的ctypes调用nvapi64.dll设置显示器亮度、对比度和Gamma参数，编写了如下代码：

import ctypes

brightness = 52
contrast = 27
gamma = 1.40

def setBrightness(brightness):
    nvapi = ctypes.WinDLL("nvapi64.dll")
    handle = ctypes.c_uint()
    nvapi.NvAPI_Initialize()
    nvapi.NvAPI_GetPhysicalGPUsFromDisplay(ctypes.byref(handle))
    nvapi.NvAPI_GPU_SetBrightness(handle.value, ctypes.c_uint(brightness))
    nvapi.NvAPI_Unload()

def setContrast(contrast):
    nvapi = ctypes.WinDLL("nvapi64.dll")
    handle = ctypes.c_uint()
    nvapi.NvAPI_Initialize()
    nvapi.NvAPI_GetPhysicalGPUsFromDisplay(ctypes.byref(handle))
    nvapi.NvAPI_GPU_SetContrast(handle.value, ctypes.c_uint(contrast))
    nvapi.NvAPI_Unload()

def setGamma(gamma):
    nvapi = ctypes.WinDLL("nvapi64.dll")
    handle = ctypes.c_uint()
    nvapi.NvAPI_Initialize()
    nvapi.NvAPI_GetPhysicalGPUsFromDisplay(ctypes.byref(handle))
    nvapi.NvAPI_GPU_SetGamma(handle.value, ctypes.c_float(gamma))
    nvapi.NvAPI_Unload()

setBrightness(brightness)
setContrast(contrast)
setGamma(gamma)

运行时出现错误：

File "C:\Python38\lib\ctypes\__init__.py", line 391, in __getitem__
    func = self._FuncPtr((name_or_ordinal, self))
AttributeError: function 'NvAPI_Initialize' not found

核心原因 #

NVAPI的大部分核心函数（包括NvAPI_Initialize）并非直接从nvapi64.dll导出，无法通过直接访问dll属性的方式调用，必须通过NvAPI_QueryInterface函数获取目标函数的指针。此外原代码还存在重复加载dll、GPU句柄获取逻辑错误、未处理函数返回值等问题。

修正步骤与代码 #

1. 正确获取NVAPI函数指针：先加载nvapi64.dll并获取NvAPI_QueryInterface，再用它查询其他函数的地址。
2. 统一初始化与卸载：避免每个函数重复执行初始化和卸载操作，减少资源消耗。
3. 修正GPU句柄获取逻辑：NvAPI_GetPhysicalGPUsFromDisplay需要传入数组存储GPU句柄，而非单个变量。
4. 检查函数返回值：NVAPI函数会返回错误码，可用于排查调用失败的原因。

修正后的代码：

import ctypes
from ctypes import wintypes

# 定义NVAPI常用常量与类型
NVAPI_OK = 0
NvPhysicalGpuHandle = wintypes.HANDLE

# 加载nvapi64.dll
nvapi_dll = ctypes.WinDLL("nvapi64.dll")

# 定义NvAPI_QueryInterface的函数原型
NvAPI_QueryInterface = nvapi_dll.NvAPI_QueryInterface
NvAPI_QueryInterface.argtypes = [wintypes.DWORD]
NvAPI_QueryInterface.restype = ctypes.CFUNCTYPE(None)

# 通过查询接口获取目标函数指针
def get_nvapi_function(func_ordinal, restype, argtypes):
    func_ptr = NvAPI_QueryInterface(func_ordinal)
    func = ctypes.CFUNCTYPE(restype, *argtypes)(func_ptr)
    return func

# 获取各个NVAPI函数（序数为NVAPI公开标准值）
NvAPI_Initialize = get_nvapi_function(0x0150E828, wintypes.LONG, [])
NvAPI_Unload = get_nvapi_function(0xD22BDD7E, wintypes.LONG, [])
NvAPI_GetPhysicalGPUsFromDisplay = get_nvapi_function(0x1FAE26F0, wintypes.LONG, [wintypes.HWND, wintypes.PDWORD, NvPhysicalGpuHandle])
NvAPI_GPU_SetBrightness = get_nvapi_function(0x1A41DFD0, wintypes.LONG, [NvPhysicalGpuHandle, wintypes.DWORD])
NvAPI_GPU_SetContrast = get_nvapi_function(0x6693AE08, wintypes.LONG, [NvPhysicalGpuHandle, wintypes.DWORD])
NvAPI_GPU_SetGamma = get_nvapi_function(0x49062416, wintypes.LONG, [NvPhysicalGpuHandle, ctypes.c_float])

def set_display_parameters(brightness, contrast, gamma):
    # 初始化NVAPI
    ret = NvAPI_Initialize()
    if ret != NVAPI_OK:
        print(f"NvAPI初始化失败，错误码: {ret}")
        return

    try:
        # 获取当前主显示器对应的GPU句柄
        gpu_count = wintypes.DWORD(0)
        gpu_handle = NvPhysicalGpuHandle()
        ret = NvAPI_GetPhysicalGPUsFromDisplay(None, ctypes.byref(gpu_count), gpu_handle)
        if ret != NVAPI_OK:
            print(f"获取GPU句柄失败，错误码: {ret}")
            return

        # 设置亮度
        ret = NvAPI_GPU_SetBrightness(gpu_handle, brightness)
        if ret != NVAPI_OK:
            print(f"设置亮度失败，错误码: {ret}")

        # 设置对比度
        ret = NvAPI_GPU_SetContrast(gpu_handle, contrast)
        if ret != NVAPI_OK:
            print(f"设置对比度失败，错误码: {ret}")

        # 设置Gamma
        ret = NvAPI_GPU_SetGamma(gpu_handle, gamma)
        if ret != NVAPI_OK:
            print(f"设置Gamma失败，错误码: {ret}")

    finally:
        # 卸载NVAPI
        NvAPI_Unload()

# 调用设置函数
set_display_parameters(52, 27, 1.40)

注意事项 #

• 函数序数：代码中使用的函数序数是NVAPI公开的标准值，适用于多数版本的nvapi64.dll，若出现函数查询失败，需核对对应NVAPI版本的序数表。
• 权限要求：修改显示器参数通常需要管理员权限，建议以管理员身份运行Python脚本。
• 版本兼容性：确保使用的nvapi64.dll与系统中的NVIDIA驱动版本匹配，若dll加载失败，可指定完整路径（如C:\Windows\System32\nvapi64.dll）。

内容的提问来源于stack exchange，提问作者Maran