如何在Python的ctypes中创建HDC类型变量调用SMX150相机API

核心说明 #

HDC是Windows系统的设备上下文句柄，本质为指针类型，在Python ctypes中可通过ctypes.HANDLE、ctypes.c_void_p或更规范的wintypes.HDC来对应。以下分两种常用场景给出实现方案：

场景1：获取现有窗口的HDC（用于视频预览） #

若需将相机画面显示到指定窗口，可借助pywin32库获取窗口对应的HDC：

1. 安装依赖：

pip install pywin32

2. 示例代码：

import tkinter as tk
import win32gui
import ctypes
from ctypes import wintypes

# 加载相机DLL
smx_dll = ctypes.WinDLL("你的相机DLL完整路径.dll")

# 严格定义函数参数与返回值类型（必须，避免类型错误）
smx_dll.CxStartVideo.argtypes = [wintypes.HDC, ctypes.c_int]
smx_dll.CxStartVideo.restype = ctypes.c_bool

# 创建用于预览的Tkinter窗口
root = tk.Tk()
root.title("SMX 150相机预览")
root.geometry("640x480")

# 获取窗口句柄及对应HDC
hwnd = root.winfo_id()
hdc = win32gui.GetDC(hwnd)

# 调用相机函数（替换为实际获取到的DeviceId）
device_id = 1
success = smx_dll.CxStartVideo(hdc, device_id)

print("视频启动成功" if success else "视频启动失败")

# 释放DC资源（必须，防止内存泄漏）
win32gui.ReleaseDC(hwnd, hdc)

root.mainloop()

场景2：创建内存HDC（用于离线图像处理） #

若无需显示画面，仅需获取相机图像数据，可创建内存设备上下文：

import ctypes
from ctypes import wintypes

# 加载Windows系统库
gdi32 = ctypes.WinDLL("gdi32")

# 定义CreateCompatibleDC的类型签名
gdi32.CreateCompatibleDC.argtypes = [wintypes.HDC]
gdi32.CreateCompatibleDC.restype = wintypes.HDC
gdi32.DeleteDC.argtypes = [wintypes.HDC]
gdi32.DeleteDC.restype = wintypes.BOOL

# 创建内存HDC（传入0表示基于屏幕DC创建兼容内存DC）
hdc_mem = gdi32.CreateCompatibleDC(0)

# 加载相机DLL并调用函数
smx_dll = ctypes.WinDLL("你的相机DLL完整路径.dll")
smx_dll.CxStartVideo.argtypes = [wintypes.HDC, ctypes.c_int]
smx_dll.CxStartVideo.restype = ctypes.c_bool

device_id = 1
success = smx_dll.CxStartVideo(hdc_mem, device_id)

print("视频启动成功" if success else "视频启动失败")

# 销毁内存DC（必须释放资源）
gdi32.DeleteDC(hdc_mem)

关键注意事项 #

• 必须显式设置函数的argtypes和restype，否则ctypes会自动进行不安全的类型转换，导致调用失败或程序崩溃。
• 所有获取/创建的HDC都要在使用完毕后释放（ReleaseDC或DeleteDC），避免系统资源泄漏。

内容的提问来源于stack exchange，提问作者Miłosz Wiśniewski