python - 使用 Cython 为困难的 C 头文件编写 Python 包装器

Question

不久前，我围绕商业 DAQ 库编写了一个薄包装器 使用ctypes。从那时起我遇到了 Cython 并想给予 尝试一下，认为这可能会让一切变得更好/更干净 我以前有过。大多数 Cython 文档都很有意义，而且我已经 找到了我所知道的大部分内容，但我正在包装的库是高度 Windows 特定的并且做的事情与标准 C/C+ 略有不同 + 代码，至少据我所知。

这是头文件中的几个片段，我并不完全清楚 确定如何包装。

<小时/>

#ifndef DAQ_H
#define DAQ_H

#ifdef   __cplusplus
extern "C" {
#endif

#if !defined(_DAQAPI32_)
  #define  DAQAPI   __declspec(dllimport)
#else
  #define  DAQAPI
#endif

<小时/>

根据我收集的信息，我可能可以忽略我的 cython 中的大部分内容 定义？我尝试过使用 gcc 编译 C 代码，但它在每个函数定义中都会引发错误。使用ctypes我直接访问了库，根本没有使用头文件。

<小时/>

/* Handle Type Definition */
typedef  INT   DaqHandleT;

/* Initialization and Locking Prototypes */
DAQAPI DaqHandleT WINAPI   daqOpen(LPSTR daqName);
DAQAPI DaqError WINAPI     daqClose(DaqHandleT handle);
DAQAPI DaqError WINAPI     daqOnline(DaqHandleT handle, PBOOL online);

/* Error Handler Type Definitions */
typedef VOID CALLBACK      DaqErrorHandlerFT(DaqHandleT handle,
DaqError errCode);
typedef DaqErrorHandlerFT  *DaqErrorHandlerFPT;

/* Error Handler Function Prototypes */
DAQAPI DaqError WINAPI  daqSetDefaultErrorHandler(DaqErrorHandlerFPT
handler);
DAQAPI DaqError WINAPI  daqSetErrorHandler(DaqHandleT handle,
DaqErrorHandlerFPT handler);
DAQAPI DaqError WINAPI  daqProcessError(DaqHandleT handle, DaqError
errCode);
DAQAPI DaqError WINAPI  daqGetLastError(DaqHandleT handle, DaqError
*errCode);
DAQAPI VOID CALLBACK    daqDefaultErrorHandler(DaqHandleT handle,
DaqError errCode);
DAQAPI DaqError WINAPI  daqFormatError(DaqError errorNum, PCHAR msg);

<小时/>

这基本上是大多数函数的声明和操作方式。他们 只返回错误代码，从中获取的所有重要信息是 通过指针完成。我在文档中找不到任何内容 关于如何使用返回类型的指针，我可能没有看过 够难的了。

任何人都可以指出我包装这些类型的正确方向吗？ 功能？

像DaqError这样的东西实际上是在头文件中声明的枚举， 他们在这个库中进行了疯狂的枚举，大约有 1500 行。

感谢您的帮助，

Answer 1

使用返回类型创建 cython typedef。这样，cython 将使用原始库的相同宏。

cdef extern from "header.h":

    ctypedef void * win_api_t "DAQAPI DaqHandleT WINAPI"
    win_api_t daqOpen( char* )  

cpdef pyDaqOpen( pystr ):
    daqOpen(pystr)