理解 ctypes 中冗余的原型参数规范

本文旨在修补 ctypes 库中函数原型参数规范中 DEFAULT_ZERO 标志的用途，并解释与直接指定默认值的区别。通过示例代码，我们将演示如何使用正确的 ctypes 定义 Windows API 函数，并避免常见的 TypeError 错误。此外，改介绍使用 .arg其types 和 .restype属性函数参数和返回值类型的替代方法，以提高代码的约束性和可维护性。

在Python中使用ctypes库与C动态链接库（DLL）进行交互时，理解函数原型参数的正确规范至关重要。特别是当涉及参数的默认值时，ctypes提供了一些选项，但如果不正确使用，可能会导致意外的行为和错误。DEFAULT_ZERO的特殊启示

ctypes文档中提到，参数类型为 4（即 DEFAULT_ZERO）表示输入参数的默认值为整数零。但是，简单地在第三个元组元素中指定 0 似乎也能达到相同的效果。那么，DEFAULT_ZERO的真正作用是什么？

实际上，DEFAULT_ZERO标志的含义是“不要传递参数...使用默认值作为输入”。这意味着，当使用DEFAULT_ZERO标记参数时，调用函数时不能显地传递该参数。与指定默认值不同，稍后允许在调用时局部地覆盖默认值。这示例：WlanRegisterNotification函数

考虑 Windows API 函数 WlanRegisterNotification。如果我们使用 DEFAULT_ZERO 为 pReserved 参数指定默认值，则在调用该函数时，不能显式地传递 pReserved 参数。否则，会引发 TypeError: call gets正好 N 个参数 (N 1给定) 错误。

以下代码演示了正确使用 DEFAULT_ZERO 的方法：import ctypesimport ctypes.wintypesPWLAN_NOTIFICATION_DATA = ctypes.c_void_pWLAN_NOTIFICATION_CALLBACK = ctypes.WINFUNCTYPE(None， PWLAN_NOTIFICATION_DATA， ctypes.wintypes.LPVOID)null_callback = WLAN_NOTIFICATION_CALLBACK()#有效回调@WLAN_NOTIFICATION_CALLBACKdef回调(param1， param2)： print(param1， param2)IN = 1OUT = 2DEFAULT_ZERO = 4wlanapi = ctypes.WinDLL('wlanapi')proto = ctypes.WINFUNCTYPE( ctypes.wintypes.DWORD， ctypes.wintypes.HANDLE， ctypes.wintypes.DWORD， ctypes.wintypes.BOOL， WLAN_NOTIFICATION_CALLBACK， ctypes.wintypes.LPVOID， ctypes.wintypes.LPVOID， ctypes.POINTER(ctypes.wintypes.DWORD)，)fun = proto( ('WlanRegisterNotification'， wlanapi)， ( (IN， 'hClientHandle')， (IN， 'dwNotifSource')， (IN， 'bIgnoreDuplicate')， (IN， 'funcCallback'， null_callback)， (IN， 'pCallbackContext'， None)， (IN | DEFAULT_ZERO， 'pReserved')， (OUT， 'pdwPrevNotifSource')， )，)fun.errcheck = lambda result， func， args： (result， args[5])print(fun(0，0，0))print(fun(0，0，0，callback))print(fun(0，0，0，callback，None))# print(fun(0，0，0，callback，None，None)) # 这会失败。 pReserved 无法传递。登录后复制

在这个例子中，pReserved 参数使用了 DEFAULT_ZERO 标志。因此，在调用 fun 函数时，我们不能显式地传递 pReserved 参数。如果尝试传递，将会引发 TypeError 错误。

注意：对于回调函数和 LPVOID 类型的参数，int(0) 通常不是有效的默认值。

对于回调函数，可以使用 None 或空的回调函数实例作为默认值。对于 LPVOID，可以使用 None 作为默认值。使用 .argtypes 和 .restype 的替代方法

除了使用 ctypes.WINFUNCTYPE 和参数标志外，还可以使用 .argtypes 和 .restype属性来定义函数的此类类型和返回值类型。方法通常更简洁、更易读，并且可以避免一些与参数标记相关的陷阱。

以下代码演示了如何使用 .argtypes 和 .restype WlanRegisterNotification 函数：import ctypes as ctimport ctypes.wintypes as wPWLAN_NOTIFICATION_DATA = ct.c_void_pWLAN_NOTIFICATION_CALLBACK = ct.WINFUNCTYPE(无， PWLAN_NOTIFICATION_DATA， w.LPVOID)null_callback = WLAN_NOTIFICATION_CALLBACK()# valid回调@WLAN_NOTIFICATION_CALLBACKdef 回调(参数1， 参数2)： 打印(参数1， 参数2)wlanapi = ct.WinDLL('wlanapi')wlanapi.WlanRegisterNotification.argtypes = w.HANDLE， w.DWORD， w.BOOL， WLAN_NOTIFICATION_CALLBACK， w.LPVOID， w.LPVOID， ct.POINTER(w.DWORD)wlanapi.WlanRegisterNotification.restype = w.DWORDdef fun(h， src， 忽略， cb=null_callback， context=None)： prev = w.DWORD() result = wlanapi.WlanRegisterNotification(h， src， 忽略， cb， context， None， ct.byref(prev)) 返回结果， prev.valueprint(fun(0， 0， 0))print(fun(0， 0， 0， callback))print(fun(0， 0， 0，callback， None))# print(fun(0， 0， 0，callback， None， None)) # 这会失败。 pReserved 不能通过。登录后复制

在这个例子中，我们首先使用 wlanapi.WlanRegisterNotification.argtypes 属性定义了函数的参数类型，然后使用 wlanapi.WlanRegisterNotification.restype 属性定义了函数的返回值类型。最后，我们定义了一个包装函数 fun，该函数负责调用 WlanRegisterNotification 函数，并处理返回值。

总结：DEFAULT_ZERO 标志表示不传递参数，而是使用默认值。使用 DEFAULT_ZERO 标记的参数不能在调用函数时显式地传递。可以使用 .argtypes 和 .restype 属性来定义函数的参数类型和返回值类型，这通常更简洁、更易读。在使用 ctypes 定义 Windows API 时函数时，一定要仔细阅读文档，并理解每个参数的含义和类型。直接照搬问题源，要避免融合、改写、优化表达。

通过理解ctypes中参数规范的，我们更有效地使用ctypes可以与C动态链接库进行交互，并避免常见的错误。

以上就是理解ctypes中的原型内容参数规范的详细细节，更多请关注乐常识网其他相关文章！