MvSdkExport.h 169 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853
  1. #ifndef _MV_SDK_EXPORT_H__
  2. #define _MV_SDK_EXPORT_H__
  3. #include "MvErrorDefine.h"
  4. #include "CameraParams.h"
  5. #ifndef MVSDKEXPORT_API
  6. #ifdef _WIN32
  7. #if defined(MVSDKEXPORT_EXPORTS)
  8. #define MVSDKEXPORT_API __declspec(dllexport)
  9. #else
  10. #define MVSDKEXPORT_API __declspec(dllimport)
  11. #endif
  12. #else
  13. #ifndef __stdcall
  14. #define __stdcall
  15. #endif
  16. #ifndef MVSDKEXPORT_API
  17. #define MVSDKEXPORT_API
  18. #endif
  19. #endif
  20. #endif
  21. #ifndef IN
  22. #define IN
  23. #endif
  24. #ifndef OUT
  25. #define OUT
  26. #endif
  27. #ifdef __cplusplus
  28. extern "C" {
  29. #endif
  30. /************************************************************************/
  31. /* 相机的基本指令和操作 */
  32. /* Camera basic instructions and operations */
  33. /************************************************************************/
  34. /************************************************************************
  35. * @fn MV_CC_GetSDKVersion()
  36. * @brief 获取SDK版本号
  37. * @param
  38. * @return 始终返回4字节版本号 |主 |次 |修正 | 测试|
  39. 8bits 8bits 8bits 8bits
  40. * @fn MV_CC_GetSDKVersion()
  41. * @brief Get SDK Version
  42. * @param
  43. * @return Always return 4 Bytes of version number |Main |Sub |Rev | Test|
  44. 8bits 8bits 8bits 8bits
  45. ************************************************************************/
  46. MVSDKEXPORT_API unsigned int __stdcall MV_CC_GetSDKVersion();
  47. /************************************************************************
  48. * @fn MV_CC_EnumerateTls()
  49. * @brief 获取支持的传输层
  50. * @return 支持的传输层编号
  51. * @fn MV_CC_EnumerateTls()
  52. * @brief Get supported Transport Layer
  53. * @return Supported Transport Layer number
  54. ************************************************************************/
  55. MVSDKEXPORT_API int __stdcall MV_CC_EnumerateTls();
  56. /************************************************************************
  57. * @fn MV_CC_EnumDevices()
  58. * @brief 枚举设备
  59. * @param nTLayerType [IN] 枚举传输层
  60. * @param pstDevList [OUT] 设备列表
  61. * @return 成功,返回MV_OK;错误,返回错误码
  62. * @fn MV_CC_EnumDevices()
  63. * @brief Enumerate Device
  64. * @param nTLayerType [IN] Enumerate TLs
  65. * @param pstDevList [OUT] Device List
  66. * @return Success, return MV_OK. Failure, return error code
  67. ************************************************************************/
  68. MVSDKEXPORT_API int __stdcall MV_CC_EnumDevices(IN unsigned int nTLayerType, IN OUT MV_CC_DEVICE_INFO_LIST* pstDevList);
  69. /************************************************************************
  70. * @fn MV_CC_EnumDevicesEx()
  71. * @brief 根据厂商名字枚举设备
  72. * @param nTLayerType [IN] 枚举传输层
  73. * @param pstDevList [OUT] 设备列表
  74. * @param pManufacturerName [IN] 厂商名字
  75. * @return 成功,返回MV_OK;错误,返回错误码
  76. * @fn MV_CC_EnumDevicesEx()
  77. * @brief Enumerate device according to manufacture name
  78. * @param nTLayerType [IN] Transmission layer of enumeration
  79. * @param pstDevList [OUT] Device list
  80. * @param pManufacturerName [IN] Manufacture Name
  81. * @return Success, return MV_OK. Failure, return error code
  82. ************************************************************************/
  83. MVSDKEXPORT_API int __stdcall MV_CC_EnumDevicesEx(IN unsigned int nTLayerType, IN OUT MV_CC_DEVICE_INFO_LIST* pstDevList, IN const char* pManufacturerName);
  84. /************************************************************************
  85. * @fn MV_CC_IsDeviceAccessible()
  86. * @brief 设备是否可达
  87. * @param pstDevInfo [IN] 设备信息结构体
  88. * @param nAccessMode [IN] 访问权限
  89. * @return 可达,返回true;不可达,返回false
  90. * @fn MV_CC_IsDeviceAccessible()
  91. * @brief Is the device accessible
  92. * @param pstDevInfo [IN] Device Information Structure
  93. * @param nAccessMode [IN] Access Right
  94. * @return Access, return true. Not access, return false
  95. ************************************************************************/
  96. MVSDKEXPORT_API bool __stdcall MV_CC_IsDeviceAccessible(IN MV_CC_DEVICE_INFO* pstDevInfo, IN unsigned int nAccessMode);
  97. /************************************************************************
  98. * @fn MV_CC_SetSDKLogPath()
  99. * @brief 设置SDK日志路径(如果日志服务MvLogServer已启用,则该接口无效)
  100. * @param pSDKLogPath [IN] SDK日志路径
  101. * @return 成功,返回MV_OK;错误,返回错误码
  102. * @fn MV_CC_SetSDKLogPath()
  103. * @brief Set SDK log path
  104. * @param pSDKLogPath [IN] SDK log path
  105. * @return Access, return true. Not access, return false
  106. ************************************************************************/
  107. MVSDKEXPORT_API int __stdcall MV_CC_SetSDKLogPath(IN const char * pSDKLogPath);
  108. /************************************************************************
  109. * @fn MV_CC_CreateHandle()
  110. * @brief 创建设备句柄
  111. * @param handle [OUT] 句柄地址
  112. * @param pstDevInfo [IN] 设备信息结构体
  113. * @return 成功,返回MV_OK;错误,返回错误码
  114. * @fn MV_CC_CreateHandle()
  115. * @brief Create Device Handle
  116. * @param handle [OUT] Handle Address
  117. * @param pstDevInfo [IN] Device Information Structure
  118. * @return Success, return MV_OK. Failure, return error code
  119. ************************************************************************/
  120. MVSDKEXPORT_API int __stdcall MV_CC_CreateHandle(OUT void ** handle, IN const MV_CC_DEVICE_INFO* pstDevInfo);
  121. /************************************************************************
  122. * @fn MV_CC_CreateHandleWithoutLog
  123. * @brief 创建设备句柄,不生成日志
  124. * @param handle [OUT] 句柄地址
  125. * @param pstDevInfo [IN] 设备信息结构体
  126. * @return 成功,返回MV_OK;错误,返回错误码
  127. * @fn MV_CC_CreateHandleWithoutLog
  128. * @brief Create Device Handle without log
  129. * @param handle [OUT] Handle Address
  130. * @param pstDevInfo [IN] Device Information Structure
  131. * @return Success, return MV_OK. Failure, return error code
  132. ************************************************************************/
  133. MVSDKEXPORT_API int __stdcall MV_CC_CreateHandleWithoutLog(OUT void ** handle, IN const MV_CC_DEVICE_INFO* pstDevInfo);
  134. /************************************************************************
  135. * @fn MV_CC_DestroyHandle()
  136. * @brief 销毁设备句柄
  137. * @param handle [IN] 句柄
  138. * @return 成功,返回MV_OK;错误,返回错误码
  139. * @fn MV_CC_DestroyHandle()
  140. * @brief Destroy Device Handle
  141. * @param handle [IN] Handle
  142. * @return Success, return MV_OK. Failure, return error code
  143. ************************************************************************/
  144. MVSDKEXPORT_API int __stdcall MV_CC_DestroyHandle(IN void * handle);
  145. /************************************************************************
  146. * @fn MV_CC_OpenDevice()
  147. * @brief 打开设备
  148. * @param handle [IN] 句柄
  149. * @param nAccessMode [IN] 访问权限
  150. * @param nSwitchoverKey [IN] 切换访问权限时的密钥
  151. * @return 成功,返回MV_OK;错误,返回错误码
  152. * @fn MV_CC_OpenDevice()
  153. * @brief Open Device
  154. * @param handle [IN] Handle
  155. * @param nAccessMode [IN] Access Right
  156. * @param nSwitchoverKey [IN] Switch key of access right
  157. * @return Success, return MV_OK. Failure, return error code
  158. ************************************************************************/
  159. MVSDKEXPORT_API int __stdcall MV_CC_OpenDevice(IN void* handle, IN unsigned int nAccessMode, IN unsigned short nSwitchoverKey);
  160. /***********************************************************************
  161. * @fn MV_CC_CloseDevice
  162. * @brief 关闭相机
  163. * @param handle [IN] 句柄
  164. * @return 成功,返回MV_OK;错误,返回错误码
  165. * @fn MV_CC_CloseDevice
  166. * @brief Close Device
  167. * @param handle [IN] Handle
  168. * @return Success, return MV_OK. Failure, return error code
  169. ***********************************************************************/
  170. MVSDKEXPORT_API int __stdcall MV_CC_CloseDevice(IN void* handle);
  171. /***********************************************************************
  172. * @fn MV_CC_IsDeviceConnected
  173. * @brief 判断相机是否处于连接状态
  174. * @param handle [IN] 句柄
  175. * @return 设备处于连接状态,返回true;没连接或失去连接,返回false
  176. * @fn MV_CC_IsDeviceConnected
  177. * @brief Is The Device Connected
  178. * @param handle [IN] Handle
  179. * @return Connected, return true. Not Connected or DIsconnected, return false
  180. ***********************************************************************/
  181. MVSDKEXPORT_API bool __stdcall MV_CC_IsDeviceConnected(IN void* handle);
  182. /***********************************************************************
  183. * @fn MV_CC_RegisterImageCallBackEx
  184. * @brief 注册图像数据回调,chunk
  185. * @param handle [IN] 句柄
  186. * @param cbOutput [IN] 回调函数指针
  187. * @param pUser [IN] 用户自定义变量
  188. * @return 成功,返回MV_OK;错误,返回错误码
  189. * @fn MV_CC_RegisterImageCallBackEx
  190. * @brief register image data callback, chunk
  191. * @param handle [IN] Handle
  192. * @param cbOutput [IN] Callback function pointer
  193. * @param pUser [IN] User defined variable
  194. * @return Success, return MV_OK. Failure, return error code
  195. ***********************************************************************/
  196. MVSDKEXPORT_API int __stdcall MV_CC_RegisterImageCallBackEx(void* handle, void(__stdcall* cbOutput)(unsigned char * pData, MV_FRAME_OUT_INFO_EX* pFrameInfo, void* pUser),void* pUser);
  197. /***********************************************************************
  198. * @fn MV_CC_RegisterImageCallbackForRGB
  199. * @brief 注册图像数据回调,RGB
  200. * @param handle [IN] 句柄
  201. * @param cbOutput [IN] 回调函数指针
  202. * @param pUser [IN] 用户自定义变量
  203. * @return 成功,返回MV_OK;错误,返回错误码
  204. * @fn MV_CC_RegisterImageCallbackForRGB
  205. * @brief register image data callback, RGB
  206. * @param handle [IN] Handle
  207. * @param cbOutput [IN] Callback function pointer
  208. * @param pUser [IN] User defined variable
  209. * @return Success, return MV_OK. Failure, return error code
  210. ***********************************************************************/
  211. MVSDKEXPORT_API int __stdcall MV_CC_RegisterImageCallBackForRGB(void* handle, void(__stdcall* cbOutput)(unsigned char * pData, MV_FRAME_OUT_INFO_EX* pFrameInfo, void* pUser),void* pUser);
  212. /***********************************************************************
  213. * @fn MV_CC_RegisterImageCallbackForBGR
  214. * @brief 注册图像数据回调,BGR
  215. * @param handle [IN] 句柄
  216. * @param cbOutput [IN] 回调函数指针
  217. * @param pUser [IN] 用户自定义变量
  218. * @return 成功,返回MV_OK;错误,返回错误码
  219. * @fn MV_CC_RegisterImageCallbackForBGR
  220. * @brief register image data callback, BGR
  221. * @param handle [IN] Handle
  222. * @param cbOutput [IN] Callback function pointer
  223. * @param pUser [IN] User defined variable
  224. * @return Success, return MV_OK. Failure, return error code
  225. ***********************************************************************/
  226. MVSDKEXPORT_API int __stdcall MV_CC_RegisterImageCallBackForBGR(void* handle, void(__stdcall* cbOutput)(unsigned char * pData, MV_FRAME_OUT_INFO_EX* pFrameInfo, void* pUser),void* pUser);
  227. /***********************************************************************
  228. * @fn MV_CC_StartGrabbing
  229. * @brief 开始取流
  230. * @param handle [IN] 句柄
  231. * @return 成功,返回MV_OK;错误,返回错误码
  232. * @fn MV_CC_StartGrabbing
  233. * @brief Start Grabbing
  234. * @param handle [IN] Handle
  235. * @return Success, return MV_OK. Failure, return error code
  236. ***********************************************************************/
  237. MVSDKEXPORT_API int __stdcall MV_CC_StartGrabbing(IN void* handle);
  238. /***********************************************************************
  239. * @fn MV_CC_StopGrabbing
  240. * @brief 停止取流
  241. * @param handle [IN] 句柄
  242. * @return 成功,返回MV_OK;错误,返回错误码
  243. * @fn MV_CC_StopGrabbing
  244. * @brief Stop Grabbing
  245. * @param handle [IN] Handle
  246. * @return Success, return MV_OK. Failure, return error code
  247. ***********************************************************************/
  248. MVSDKEXPORT_API int __stdcall MV_CC_StopGrabbing(IN void* handle);
  249. /***********************************************************************
  250. * @fn MV_CC_GetImageForRGB
  251. * @brief 获取一帧RGB数据,此函数为查询式获取,每次调用查询内部
  252. 缓存有无数据,有数据则范围数据,无数据返回错误码
  253. * @param handle [IN] 句柄
  254. * @param pData [OUT] 图像数据接收指针
  255. * @param nDataSize [IN] 接收缓存大小
  256. * @param pFrameInfo [OUT] 图像信息结构体
  257. * @param nMsec [IN] 等待超时时间
  258. * @return 成功,返回MV_OK;错误,返回错误码
  259. * @fn MV_CC_GetImageForRGB
  260. * @brief Get one frame of RGB data, this function is using query to get data,
  261. query whether the internal cache has data, return data if there has, return error code if no data
  262. * @param handle [IN] Handle
  263. * @param pData [OUT] Recevied image data pointer
  264. * @param nDataSize [IN] Recevied buffer size
  265. * @param pFrameInfo [OUT] Image information structure
  266. * @param nMsec [IN] Waiting timeout
  267. * @return Success, return MV_OK. Failure, return error code
  268. ***********************************************************************/
  269. MVSDKEXPORT_API int __stdcall MV_CC_GetImageForRGB(IN void* handle, IN OUT unsigned char * pData , IN unsigned int nDataSize, IN OUT MV_FRAME_OUT_INFO_EX* pFrameInfo, int nMsec);
  270. /***********************************************************************
  271. * @fn MV_CC_GetImageForBGR
  272. * @brief 获取一帧BGR数据,此函数为查询式获取,每次调用查询内部
  273. 缓存有无数据,有数据则范围数据,无数据返回错误码
  274. * @param handle [IN] 句柄
  275. * @param pData [OUT] 图像数据接收指针
  276. * @param nDataSize [IN] 接收缓存大小
  277. * @param pFrameInfo [OUT] 图像信息结构体
  278. * @param nMsec [IN] 等待超时时间
  279. * @return 成功,返回MV_OK;错误,返回错误码
  280. * @fn MV_CC_GetImageForBGR
  281. * @brief Get one frame of BGR data, this function is using query to get data,
  282. query whether the internal cache has data, return data if there has, return error code if no data
  283. * @param handle [IN] Handle
  284. * @param pData [OUT] Recevied image data pointer
  285. * @param nDataSize [IN] Recevied buffer size
  286. * @param pFrameInfo [OUT] Image information structure
  287. * @param nMsec [IN] Waiting timeout
  288. * @return Success, return MV_OK. Failure, return error code
  289. ***********************************************************************/
  290. MVSDKEXPORT_API int __stdcall MV_CC_GetImageForBGR(IN void* handle, IN OUT unsigned char * pData , IN unsigned int nDataSize, IN OUT MV_FRAME_OUT_INFO_EX* pFrameInfo, int nMsec);
  291. /***********************************************************************
  292. * @fn MV_CC_GetImageBuffer
  293. * @brief 采用超时机制获取一帧图片,SDK内部等待直到有数据时返回,
  294. 此接口可以增加取流平稳性,适合用于对平稳性要求较高的场合(与MV_CC_Display不能同时使用)
  295. * @param handle [IN] 句柄
  296. * @param pFrame [OUT] 图像数据首地址和图像信息
  297. * @param nMsec [IN] 等待超时时间,输入INFINITE时表示无限等待,直到收到一帧数据或者停止取流
  298. * @return 成功,返回MV_OK;错误,返回错误码
  299. * @fn MV_CC_GetImageBuffer
  300. * @brief Timeout mechanism is used to get image, and the SDK waits inside until the data is returned,
  301. this interface can increase the flow stability, and is suitable for occasions with higher stability requirements
  302. * @param handle [IN] Handle
  303. * @param pFrame [OUT] Pointer of recevied image data and info
  304. * @param nMsec [IN] Waiting timeout
  305. * @return Success, return MV_OK. Failure, return error code
  306. ***********************************************************************/
  307. MVSDKEXPORT_API int __stdcall MV_CC_GetImageBuffer(IN void* handle, OUT MV_FRAME_OUT* pFrame, int nMsec);
  308. /***********************************************************************
  309. * @fn MV_CC_FreeImageBuffer
  310. * @brief 释放图像缓存(此接口用于释放不再使用的图像缓存,与MV_CC_GetImageBuffer配套使用)
  311. * @param handle [IN] 句柄
  312. * @param pFrame [IN] 图像数据和信息接收指针
  313. * @return 成功,返回MV_OK;错误,返回错误码
  314. * @fn MV_CC_FreeImageBuffer
  315. * @brief Free image buffer(this interface can free image buffer, used with MV_CC_GetImageBuffer)
  316. * @param handle [IN] Handle
  317. * @param pFrame [IN] Pointer of recevied image data and info
  318. * @return Success, return MV_OK. Failure, return error code
  319. ***********************************************************************/
  320. MVSDKEXPORT_API int __stdcall MV_CC_FreeImageBuffer(IN void* handle, IN MV_FRAME_OUT* pFrame);
  321. /***********************************************************************
  322. * @fn MV_CC_GetOneFrameTimeout
  323. * @brief 采用超时机制获取一帧图片,SDK内部等待直到有数据时返回,
  324. 此接口可以增加取流平稳性,适合用于对平稳性要求较高的场合
  325. * @param handle [IN] 句柄
  326. * @param pData [OUT] 图像数据接收指针
  327. * @param nDataSize [IN] 接收缓存大小
  328. * @param pFrameInfo [OUT] 图像信息结构体
  329. * @param nMsec [IN] 等待超时时间
  330. * @return 成功,返回MV_OK;错误,返回错误码
  331. * @fn MV_CC_GetOneFrameTimeout
  332. * @brief Timeout mechanism is used to get image, and the SDK waits inside until the data is returned,
  333. this interface can increase the flow stability, and is suitable for occasions with higher stability requirements
  334. * @param handle [IN] Handle
  335. * @param pData [OUT] Recevied image data pointer
  336. * @param nDataSize [IN] Recevied buffer size
  337. * @param pFrameInfo [OUT] Image information structure
  338. * @param nMsec [IN] Waiting timeout
  339. * @return Success, return MV_OK. Failure, return error code
  340. ***********************************************************************/
  341. MVSDKEXPORT_API int __stdcall MV_CC_GetOneFrameTimeout(IN void* handle, IN OUT unsigned char * pData , IN unsigned int nDataSize, IN OUT MV_FRAME_OUT_INFO_EX* pFrameInfo, unsigned int nMsec);
  342. /***********************************************************************
  343. * @fn MV_CC_Display
  344. * @brief 显示图像,注册显示窗口,内部自动显示(与MV_CC_GetImageBuffer不能同时使用)
  345. * @param handle [IN] 句柄
  346. * @param hWnd [IN] 显示窗口句柄
  347. * @return 成功,返回MV_OK;错误,返回错误码
  348. * @fn MV_CC_Display
  349. * @brief Display one frame image, register display window, automatic display internally
  350. * @param handle [IN] Handle
  351. * @param hWnd [IN] Display Window Handle
  352. * @return Success, return MV_OK. Failure, return error code
  353. ***********************************************************************/
  354. MVSDKEXPORT_API int __stdcall MV_CC_Display(IN void* handle, void* hWnd);
  355. /***********************************************************************
  356. * @fn MV_CC_DisplayOneFrame
  357. * @brief 显示一帧图像
  358. * @param handle [IN] 句柄
  359. * @param pDisplayInfo [IN] 图像信息
  360. * @return 成功,返回MV_OK;错误,返回错误码
  361. * @fn MV_CC_DisplayOneFrame
  362. * @brief Display one frame image
  363. * @param handle [IN] Handle
  364. * @param pDisplayInfo [IN] Frame Info
  365. * @return Success, return MV_OK. Failure, return error code
  366. ***********************************************************************/
  367. MVSDKEXPORT_API int __stdcall MV_CC_DisplayOneFrame(IN void* handle, IN MV_DISPLAY_FRAME_INFO* pDisplayInfo);
  368. /***********************************************************************
  369. * @fn MV_CC_SetImageNodeNum
  370. * @brief 设置SDK内部图像缓存节点个数,范围[1, 30],在抓图前调用
  371. * @param handle [IN] 句柄
  372. * @param nNum [IN] 缓存节点个数
  373. * @return 成功,返回MV_OK;错误,返回错误码
  374. * @fn MV_CC_SetImageNodeNum
  375. * @brief Set the number of the internal image cache nodes in SDK, in the range [1, 30], to be called before the capture
  376. * @param handle [IN] Handle
  377. * @param nNum [IN] Image Node Number
  378. * @return Success, return MV_OK. Failure, return error code
  379. ***********************************************************************/
  380. MVSDKEXPORT_API int __stdcall MV_CC_SetImageNodeNum(IN void* handle, unsigned int nNum);
  381. /************************************************************************
  382. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetImageInfo(IN void* handle, IN OUT MV_IMAGE_BASIC_INFO* pstInfo);
  383. * @brief 获取图像基本信息
  384. * @param void* handle [IN] 相机句柄
  385. * @param MV_IMAGE_BASIC_INFO* pstInfo [IN][OUT] 返回给调用者有关相机图像基本信息结构体指针
  386. * @return 成功,返回MV_OK,失败,返回错误码
  387. *
  388. * 参考 CameraParam.h 中的 MV_IMAGE_BASIC_INFO 定义
  389. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetImageInfo(IN void* handle, IN OUT MV_IMAGE_BASIC_INFO* pstInfo);
  390. * @brief Get basic information of image
  391. * @param void* handle [IN] Handle
  392. * @param MV_IMAGE_BASIC_INFO* pstInfo [IN][OUT] Structure pointer of image basic information
  393. * @return Success, return MV_OK. Failure, return error code
  394. *
  395. * Refer to the definition of MV_IMAGE_BASIC_INFO in CameraParam.h
  396. ************************************************************************/
  397. MVSDKEXPORT_API int __stdcall MV_CC_GetImageInfo(IN void* handle, IN OUT MV_IMAGE_BASIC_INFO* pstInfo);
  398. /************************************************************************
  399. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetDeviceInfo(IN void* handle, IN OUT MV_CC_DEVICE_INFO* pstDevInfo);
  400. * @brief 获取设备信息
  401. * @param void* handle [IN] 相机句柄
  402. * @param MV_CC_DEVICE_INFO* pstDevInfo [IN][OUT] 返回给调用者有关相机设备信息结构体指针
  403. * @return 成功,返回MV_OK,失败,返回错误码
  404. *
  405. * 参考 CameraParam.h 中的 MV_CC_DEVICE_INFO 定义
  406. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetDeviceInfo(IN void* handle, IN OUT MV_CC_DEVICE_INFO* pstDevInfo);
  407. * @brief Get device information
  408. * @param void* handle [IN] Handle
  409. * @param MV_CC_DEVICE_INFO* pstDevInfo [IN][OUT] Structure pointer of device information
  410. * @return Success, return MV_OK. Failure, return error code
  411. *
  412. * Refer to the definition of MV_CC_DEVICE_INFO in CameraParam.h
  413. ************************************************************************/
  414. MVSDKEXPORT_API int __stdcall MV_CC_GetDeviceInfo(IN void * handle, IN OUT MV_CC_DEVICE_INFO* pstDevInfo);
  415. /************************************************************************
  416. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetAllMatchInfo(IN void* handle, IN OUT MV_ALL_MATCH_INFO* pstInfo);
  417. * @brief 获取各种类型的信息
  418. * @param void* handle [IN] 相机句柄
  419. * @param MV_ALL_MATCH_INFO* pstInfo [IN][OUT] 返回给调用者有关相机各种类型的信息结构体指针
  420. * @return 成功,返回MV_OK,失败,返回错误码
  421. *
  422. * 参考 CameraParam.h 中的 MV_ALL_MATCH_INFO 定义
  423. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetAllMatchInfo(IN void* handle, IN OUT MV_ALL_MATCH_INFO* pstInfo);
  424. * @brief Get various type of information
  425. * @param void* handle [IN] Handle
  426. * @param MV_ALL_MATCH_INFO* pstInfo [IN][OUT] Structure pointer of various type of information
  427. * @return Success, return MV_OK. Failure, return error code
  428. *
  429. * Refer to the definition of MV_ALL_MATCH_INFO in CameraParam.h
  430. ************************************************************************/
  431. MVSDKEXPORT_API int __stdcall MV_CC_GetAllMatchInfo(IN void* handle, IN OUT MV_ALL_MATCH_INFO* pstInfo);
  432. /************************************************************************/
  433. /* 设置和获取相机参数的万能接口 */
  434. /* General interface for getting and setting camera parameters */
  435. /************************************************************************/
  436. /************************************************************************
  437. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetIntValue(IN void* handle,
  438. IN const char* strKey,
  439. OUT MVCC_INTVALUE *pIntValue);
  440. * @brief 获取Integer属性值
  441. * @param void* handle [IN] 相机句柄
  442. * @param char* strKey [IN] 属性键值,如获取宽度信息则为"Width"
  443. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机属性结构体指针
  444. * @return 成功,返回MV_OK,失败,返回错误码
  445. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetIntValue(IN void* handle,
  446. IN const char* strKey,
  447. OUT MVCC_INTVALUE *pIntValue);
  448. * @brief Get Integer value
  449. * @param void* handle [IN] Handle
  450. * @param char* strKey [IN] Key value, for example, using "Width" to get width
  451. * @param MVCC_INTVALUE* pstValue [IN][OUT] Structure pointer of camera features
  452. * @return Success, return MV_OK. Failure, return error code
  453. ************************************************************************/
  454. MVSDKEXPORT_API int __stdcall MV_CC_GetIntValue(IN void* handle,IN const char* strValue,OUT MVCC_INTVALUE *pIntValue);
  455. /************************************************************************/
  456. /* 设置和获取相机参数的万能接口 */
  457. /* General interface for getting and setting camera parameters */
  458. /************************************************************************/
  459. /************************************************************************
  460. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetIntValueEx(IN void* handle,
  461. IN const char* strKey,
  462. OUT MVCC_INTVALUE *pIntValue);
  463. * @brief 获取Integer属性值
  464. * @param void* handle [IN] 相机句柄
  465. * @param char* strKey [IN] 属性键值,如获取宽度信息则为"Width"
  466. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机属性结构体指针
  467. * @return 成功,返回MV_OK,失败,返回错误码
  468. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetIntValueEx(IN void* handle,
  469. IN const char* strKey,
  470. OUT MVCC_INTVALUE *pIntValue);
  471. * @brief Get Integer value
  472. * @param void* handle [IN] Handle
  473. * @param char* strKey [IN] Key value, for example, using "Width" to get width
  474. * @param MVCC_INTVALUE* pstValue [IN][OUT] Structure pointer of camera features
  475. * @return Success, return MV_OK. Failure, return error code
  476. ************************************************************************/
  477. MVSDKEXPORT_API int __stdcall MV_CC_GetIntValueEx(IN void* handle,IN const char* strValue,OUT MVCC_INTVALUE_EX *pIntValue);
  478. /************************************************************************
  479. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetIntValue(IN void* handle,
  480. IN const char* strKey,
  481. IN unsigned int nValue);
  482. * @brief 设置Integer型属性值
  483. * @param void* handle [IN] 相机句柄
  484. * @param char* strKey [IN] 属性键值,如获取宽度信息则为"Width"
  485. * const unsigned int nValue [IN] 想要设置的相机的属性值
  486. * @return 成功,返回MV_OK,失败,返回错误码
  487. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetIntValue(IN void* handle,
  488. IN const char* strKey,
  489. IN unsigned int nValue);
  490. * @brief Set Integer value
  491. * @param void* handle [IN] Handle
  492. * @param char* strKey [IN] Key value, for example, using "Width" to set width
  493. * const unsigned int nValue [IN] Feature value to set
  494. * @return Success, return MV_OK. Failure, return error code
  495. ************************************************************************/
  496. MVSDKEXPORT_API int __stdcall MV_CC_SetIntValue(IN void* handle,IN const char* strValue,IN unsigned int nValue);
  497. /************************************************************************
  498. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetIntValueEx(IN void* handle,
  499. IN const char* strKey,
  500. IN int64_t nValue);
  501. * @brief 设置Integer型属性值
  502. * @param void* handle [IN] 相机句柄
  503. * @param char* strKey [IN] 属性键值,如获取宽度信息则为"Width"
  504. * const int64_t nValue [IN] 想要设置的相机的属性值
  505. * @return 成功,返回MV_OK,失败,返回错误码
  506. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetIntValueEx(IN void* handle,
  507. IN const char* strKey,
  508. IN int64_t nValue);
  509. * @brief Set Integer value
  510. * @param void* handle [IN] Handle
  511. * @param char* strKey [IN] Key value, for example, using "Width" to set width
  512. * const int64_t nValue [IN] Feature value to set
  513. * @return Success, return MV_OK. Failure, return error code
  514. ************************************************************************/
  515. MVSDKEXPORT_API int __stdcall MV_CC_SetIntValueEx(IN void* handle,IN const char* strValue,IN int64_t nValue);
  516. /************************************************************************
  517. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetEnumValue(IN void* handle,
  518. IN const char* strKey,
  519. OUT MVCC_ENUMVALUE *pEnumValue);
  520. * @brief 获取Enum属性值
  521. * @param void* handle [IN] 相机句柄
  522. * @param char* strKey [IN] 属性键值,如获取像素格式信息则为"PixelFormat"
  523. * @param MVCC_ENUMVALUE* pEnumValue [IN][OUT] 返回给调用者有关相机属性结构体指针
  524. * @return 成功,返回MV_OK,失败,返回错误码
  525. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetEnumValue(IN void* handle,
  526. IN const char* strKey,
  527. OUT MVCC_ENUMVALUE *pEnumValue);
  528. * @brief Get Enum value
  529. * @param void* handle [IN] Handle
  530. * @param char* strKey [IN] Key value, for example, using "PixelFormat" to get pixel format
  531. * @param MVCC_ENUMVALUE* pEnumValue [IN][OUT] Structure pointer of camera features
  532. * @return Success, return MV_OK. Failure, return error code
  533. ************************************************************************/
  534. MVSDKEXPORT_API int __stdcall MV_CC_GetEnumValue(IN void* handle,IN const char* strValue,OUT MVCC_ENUMVALUE *pEnumValue);
  535. /************************************************************************
  536. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetEnumValue(IN void* handle,
  537. IN const char* strKey,
  538. IN unsigned int nValue);
  539. * @brief 设置Enum型属性值
  540. * @param void* handle [IN] 相机句柄
  541. * @param char* strKey [IN] 属性键值,如获取像素格式信息则为"PixelFormat"
  542. * const unsigned int nValue [IN] 想要设置的相机的属性值
  543. * @return 成功,返回MV_OK,失败,返回错误码
  544. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetEnumValue(IN void* handle,
  545. IN const char* strKey,
  546. IN unsigned int nValue);
  547. * @brief Set Enum value
  548. * @param void* handle [IN] Handle
  549. * @param char* strKey [IN] Key value, for example, using "PixelFormat" to set pixel format
  550. * const unsigned int nValue [IN] Feature value to set
  551. * @return Success, return MV_OK. Failure, return error code
  552. ************************************************************************/
  553. MVSDKEXPORT_API int __stdcall MV_CC_SetEnumValue(IN void* handle,IN const char* strValue,IN unsigned int nValue);
  554. /************************************************************************
  555. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetEnumValueByString(IN void* handle,
  556. IN const char* strKey,
  557. IN const char* sValue);
  558. * @brief 设置Enum型属性值
  559. * @param void* handle [IN] 相机句柄
  560. * @param char* strKey [IN] 属性键值,如获取像素格式信息则为"PixelFormat"
  561. * char* sValue [IN] 想要设置的相机的属性字符串
  562. * @return 成功,返回MV_OK,失败,返回错误码
  563. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetEnumValue(IN void* handle,
  564. IN const char* strKey,
  565. IN const char* sValue);
  566. * @brief Set Enum value
  567. * @param void* handle [IN] Handle
  568. * @param char* strKey [IN] Key value, for example, using "PixelFormat" to set pixel format
  569. * char* sValue [IN] Feature String to set
  570. * @return Success, return MV_OK. Failure, return error code
  571. ************************************************************************/
  572. MVSDKEXPORT_API int __stdcall MV_CC_SetEnumValueByString(IN void* handle,IN const char* strValue,IN const char* sValue);
  573. /************************************************************************
  574. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetFloatValue(IN void* handle,
  575. IN const char* strKey,
  576. OUT MVCC_FLOATVALUE *pFloatValue);
  577. * @brief 获取Float属性值
  578. * @param void* handle [IN] 相机句柄
  579. * @param char* strKey [IN] 属性键值
  580. * @param MVCC_FLOATVALUE *pFloatValue [IN][OUT] 返回给调用者有关相机属性结构体指针
  581. * @return 成功,返回MV_OK,失败,返回错误码
  582. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetFloatValue(IN void* handle,
  583. IN const char* strKey,
  584. OUT MVCC_FLOATVALUE *pFloatValue);
  585. * @brief Get Float value
  586. * @param void* handle [IN] Handle
  587. * @param char* strKey [IN] Key value
  588. * @param MVCC_FLOATVALUE *pFloatValue [IN][OUT] Structure pointer of camera features
  589. * @return Success, return MV_OK. Failure, return error code
  590. ************************************************************************/
  591. MVSDKEXPORT_API int __stdcall MV_CC_GetFloatValue(IN void* handle,IN const char* strValue,OUT MVCC_FLOATVALUE *pFloatValue);
  592. /************************************************************************
  593. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetFloatValue(IN void* handle,
  594. IN const char* strKey,
  595. IN float fValue);
  596. * @brief 设置float型属性值
  597. * @param void* handle [IN] 相机句柄
  598. * @param char* strKey [IN] 属性键值
  599. * float fValue [IN] 想要设置的相机的属性值
  600. * @return 成功,返回MV_OK,失败,返回错误码
  601. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetFloatValue(IN void* handle,
  602. IN const char* strKey,
  603. IN float fValue);
  604. * @brief Set float value
  605. * @param void* handle [IN] Handle
  606. * @param char* strKey [IN] Key value
  607. * float fValue [IN] Feature value to set
  608. * @return Success, return MV_OK. Failure, return error code
  609. ************************************************************************/
  610. MVSDKEXPORT_API int __stdcall MV_CC_SetFloatValue(IN void* handle,IN const char* strValue,IN float fValue);
  611. /************************************************************************
  612. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetBoolValue(IN void* handle,
  613. IN const char* strKey,
  614. OUT bool *pBoolValue);
  615. * @brief 获取Boolean属性值
  616. * @param void* handle [IN] 相机句柄
  617. * @param char* strKey [IN] 属性键值
  618. * @param bool *pBoolValue [IN][OUT] 返回给调用者有关相机属性值
  619. * @return 成功,返回MV_OK,失败,返回错误码
  620. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetBoolValue(IN void* handle,
  621. IN const char* strKey,
  622. OUT bool *pBoolValue);
  623. * @brief Get Boolean value
  624. * @param void* handle [IN] Handle
  625. * @param char* strKey [IN] Key value
  626. * @param bool *pBoolValue [IN][OUT] Structure pointer of camera features
  627. * @return Success, return MV_OK. Failure, return error code
  628. ************************************************************************/
  629. MVSDKEXPORT_API int __stdcall MV_CC_GetBoolValue(IN void* handle,IN const char* strValue,OUT bool *pBoolValue);
  630. /************************************************************************
  631. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetBoolValue(IN void* handle,
  632. IN const char* strKey,
  633. IN bool bValue);
  634. * @brief 设置Boolean型属性值
  635. * @param void* handle [IN] 相机句柄
  636. * @param char* strKey [IN] 属性键值
  637. * bool bValue [IN] 想要设置的相机的属性值
  638. * @return 成功,返回MV_OK,失败,返回错误码
  639. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetBoolValue(IN void* handle,
  640. IN const char* strKey,
  641. IN bool bValue);
  642. * @brief Set Boolean value
  643. * @param void* handle [IN] Handle
  644. * @param char* strKey [IN] Key value
  645. * bool bValue [IN] Feature value to set
  646. * @return Success, return MV_OK. Failure, return error code
  647. ************************************************************************/
  648. MVSDKEXPORT_API int __stdcall MV_CC_SetBoolValue(IN void* handle,IN const char* strValue,IN bool bValue);
  649. /************************************************************************
  650. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetStringValue(IN void* handle,
  651. IN const char* strKey,
  652. OUT MVCC_STRINGVALUE *pStringValue);
  653. * @brief 获取String属性值
  654. * @param void* handle [IN] 相机句柄
  655. * @param char* strKey [IN] 属性键值
  656. * @param MVCC_STRINGVALUE *pStringValue [IN][OUT] 返回给调用者有关相机属性结构体指针
  657. * @return 成功,返回MV_OK,失败,返回错误码
  658. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetStringValue(IN void* handle,
  659. IN const char* strKey,
  660. OUT MVCC_STRINGVALUE *pStringValue);
  661. * @brief Get String value
  662. * @param void* handle [IN] Handle
  663. * @param char* strKey [IN] Key value
  664. * @param MVCC_STRINGVALUE *pStringValue [IN][OUT] Structure pointer of camera features
  665. * @return Success, return MV_OK. Failure, return error code
  666. ************************************************************************/
  667. MVSDKEXPORT_API int __stdcall MV_CC_GetStringValue(IN void* handle,IN const char* strKey,OUT MVCC_STRINGVALUE *pStringValue);
  668. /************************************************************************
  669. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetStringValue(IN void* handle,
  670. IN const char* strKey,
  671. IN const char * sValue);
  672. * @brief 设置String型属性值
  673. * @param void* handle [IN] 相机句柄
  674. * @param char* strKey [IN] 属性键值
  675. * char * sValue [IN] 想要设置的相机的属性值
  676. * @return 成功,返回MV_OK,失败,返回错误码
  677. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetStringValue(IN void* handle,
  678. IN const char* strKey,
  679. IN const char * sValue);
  680. * @brief Set String value
  681. * @param void* handle [IN] Handle
  682. * @param char* strKey [IN] Key value
  683. * char * sValue [IN] Feature value to set
  684. * @return Success, return MV_OK. Failure, return error code
  685. ************************************************************************/
  686. MVSDKEXPORT_API int __stdcall MV_CC_SetStringValue(IN void* handle,IN const char* strKey,IN const char * sValue);
  687. /************************************************************************
  688. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetCommandValue(IN void* handle,
  689. IN const char* strKey);
  690. * @brief 设置Command型属性值
  691. * @param void* handle [IN] 相机句柄
  692. * @param char* strKey [IN] 属性键值
  693. * @return 成功,返回MV_OK,失败,返回错误码
  694. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetCommandValue(IN void* handle,
  695. IN const char* strKey);
  696. * @brief Set Command value
  697. * @param void* handle [IN] Handle
  698. * @param char* strKey [IN] Key value
  699. * @return Success, return MV_OK. Failure, return error code
  700. ************************************************************************/
  701. MVSDKEXPORT_API int __stdcall MV_CC_SetCommandValue(IN void* handle,IN const char* strValue);
  702. /************************************************************************
  703. * @fn MV_CC_InvalidateNodes
  704. * @brief 清除GenICam节点缓存
  705. * @param handle [IN] 句柄地址
  706. * @return 成功,返回MV_OK;错误,返回错误码
  707. * @fn MV_CC_InvalidateNodes
  708. * @brief Invalidate GenICam Nodes
  709. * @param handle [IN] Handle
  710. * @return Success, return MV_OK. Failure, return error code
  711. ************************************************************************/
  712. MVSDKEXPORT_API int __stdcall MV_CC_InvalidateNodes(IN void* handle);
  713. /************************************************************************/
  714. /* 相机参数获取和设置,此模块的所有接口,将逐步废弃,建议用上面的万能接口代替 */
  715. /* Get and set camara parameters, all interfaces of this module will be replaced by general interface*/
  716. /************************************************************************/
  717. /************************************************************************
  718. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetWidth(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  719. * @brief 获取图像宽度
  720. * @param void* handle [IN] 相机句柄
  721. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机宽度的信息结构体指针
  722. * 返回的pstValue结构体的意义
  723. * unsigned int nCurValue; // 代表相机当前的宽度值
  724. * unsigned int nMax; // 表示相机允许的最大可设置的宽度值
  725. * unsigned int nMin; // 表示相机允许的最小可设置的宽度值
  726. * unsigned int nInc; // 表示相机设置的宽度增量必须是nInc的倍数,否则无效
  727. * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码
  728. *
  729. * 其他整型结构体参数的接口可参照此接口
  730. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetWidth(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  731. * @brief Get image width
  732. * @param void* handle [IN] Camera Handle
  733. * MVCC_INTVALUE* pstValue [IN][OUT] Returns the information structure pointer about the camera's width for the caller
  734. * The meaning of returns pstValue structure
  735. * unsigned int nCurValue; // Represents the current width value of the camera
  736. * unsigned int nMax; // Indicates the maximum settable width value allowed by the camera
  737. * unsigned int nMin; // Indicates the minimum settable width value allowed by the camera
  738. * unsigned int nInc; // Indicates that the width increment set by the camera must be a multiple of nInc, otherwise it is invalid
  739. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  740. *
  741. * Other Integer structure parameters interface can refer to this interface
  742. ************************************************************************/
  743. MVSDKEXPORT_API int __stdcall MV_CC_GetWidth(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  744. /************************************************************************
  745. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetWidth(IN void* handle, IN const unsigned int nValue);
  746. * @brief 设置图像宽度
  747. * @param void* handle [IN] 相机句柄
  748. * const unsigned int nValue [IN] 想要设置的相机宽度的值,注意此宽度值必须是MV_CC_GetWidth接口返回的pstValue中的nInc的倍数才能设置成功
  749. * @return 成功,返回MV_OK,并且相机宽度将会更改为相应值,失败,返回错误码
  750. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetWidth(IN void* handle, IN const unsigned int nValue);
  751. * @brief Set image width
  752. * @param void* handle [IN] Camera Handle
  753. * const unsigned int nValue [IN] To set the value of the camera width, note that the width value must be a multiple of nInc in the pstValue returned by the MV_CC_GetWidth interface
  754. * @return Success, return MV_OK, and the camera width will change to the corresponding value. Failure, return error code
  755. ************************************************************************/
  756. MVSDKEXPORT_API int __stdcall MV_CC_SetWidth(IN void* handle, IN const unsigned int nValue);
  757. /************************************************************************
  758. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetHeight(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  759. * @brief 获取图像高度
  760. * @param void* handle [IN] 相机句柄
  761. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机高度的信息结构体指针
  762. * @return 成功,返回MV_OK,并将高度信息返回到结构体中,失败,返回错误码
  763. *
  764. * 可参照接口MV_CC_GetWidth
  765. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetHeight(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  766. * @brief Get image height
  767. * @param void* handle [IN] Camera handle
  768. * @param MVCC_INTVALUE* pstValue [IN][OUT] Return pointer of information structure related to camera height to user
  769. * @return Success, return MV_OK, and return height information to the structure. Failure, return error code
  770. *
  771. * Refer to MV_CC_GetWidth
  772. ************************************************************************/
  773. MVSDKEXPORT_API int __stdcall MV_CC_GetHeight(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  774. /************************************************************************
  775. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetHeight(IN void* handle, IN const unsigned int nValue);
  776. * @brief 设置图像高度
  777. * @param void* handle [IN] 相机句柄
  778. * const unsigned int nValue [IN] 想要设置的相机宽度的值,注意此宽度值必须是MV_CC_GetWidth接口返回的pstValue中的nInc的倍数才能设置成功
  779. * @return 成功,返回MV_OK,并且相机高度将会更改为相应值,失败,返回错误码
  780. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetHeight(IN void* handle, IN const unsigned int nValue);
  781. * @brief Set image height
  782. * @param void* handle [IN] Camera Handle
  783. * const unsigned int nValue [IN] Camera height value to set, note that this value must be times of nInc of pstValue returned by MV_CC_GetWidth
  784. * @return Success, return MV_OK, and the camera height will change to the corresponding value. Failure, return error code
  785. ************************************************************************/
  786. MVSDKEXPORT_API int __stdcall MV_CC_SetHeight(IN void* handle, IN const unsigned int nValue);
  787. /************************************************************************
  788. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetAOIoffsetX(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  789. * @brief 获取图像X偏移
  790. * @param void* handle [IN] 相机句柄
  791. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机X偏移的信息结构体指针
  792. * @return 成功,返回MV_OK,失败,返回错误码
  793. *
  794. * 可参照接口MV_CC_GetWidth
  795. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetAOIoffsetX(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  796. * @brief Get image X offset
  797. * @param void* handle [IN] Camera Handle
  798. * @param MVCC_INTVALUE* pstValue [IN][OUT] Return pointer of information structure related to camera X offset to user
  799. * @return Success, return MV_OK. Failure, return error code
  800. *
  801. * Refer to MV_CC_GetWidth
  802. ************************************************************************/
  803. MVSDKEXPORT_API int __stdcall MV_CC_GetAOIoffsetX(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  804. /************************************************************************
  805. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetAOIoffsetX(IN void* handle, IN const unsigned int nValue);
  806. * @brief 设置图像AOI偏移
  807. * @param void* handle [IN] 相机句柄
  808. * const unsigned int nValue [IN] 想要设置的相机AOI的值
  809. * @return 成功,返回MV_OK,并且相机AOI偏移将会更改为相应值,失败,返回错误码
  810. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetAOIoffsetX(IN void* handle, IN const unsigned int nValue);
  811. * @brief Set image X offset
  812. * @param void* handle [IN] Camera Handle
  813. * const unsigned int nValue [IN] Camera X offset value to set
  814. * @return Success, return MV_OK, and the camera X offset will change to the corresponding value. Failure, return error code
  815. ************************************************************************/
  816. MVSDKEXPORT_API int __stdcall MV_CC_SetAOIoffsetX(IN void* handle, IN const unsigned int nValue);
  817. /************************************************************************
  818. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetAOIoffsetY(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  819. * @brief 获取图像Y偏移
  820. * @param void* handle [IN] 相机句柄
  821. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机Y偏移的信息结构体指针
  822. * @return 成功,返回MV_OK,失败,返回错误码
  823. *
  824. * 可参照接口MV_CC_GetWidth
  825. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetAOIoffsetY(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  826. * @brief Get image Y offset
  827. * @param void* handle [IN] Camera Handle
  828. * @param MVCC_INTVALUE* pstValue [IN][OUT] Return pointer of information structure related to camera Y offset to user
  829. * @return Success, return MV_OK. Failure, return error code
  830. *
  831. * Refer to MV_CC_GetWidth
  832. ************************************************************************/
  833. MVSDKEXPORT_API int __stdcall MV_CC_GetAOIoffsetY(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  834. /************************************************************************
  835. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetAOIoffsetX(IN void* handle, IN const unsigned int nValue);
  836. * @brief 设置图像AOI偏移
  837. * @param void* handle [IN] 相机句柄
  838. * const unsigned int nValue [IN] 想要设置的相机AOI的值
  839. * @return 成功,返回MV_OK,并且相机AOI偏移将会更改为相应值,失败,返回错误码
  840. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetAOIoffsetY(IN void* handle, IN const unsigned int nValue);
  841. * @brief Set image Y offset
  842. * @param void* handle [IN] Camera Handle
  843. * const unsigned int nValue [IN] Camera Y offset value to set
  844. * @return Success, return MV_OK, and the camera Y offset will change to the corresponding value. Failure, return error code
  845. ************************************************************************/
  846. MVSDKEXPORT_API int __stdcall MV_CC_SetAOIoffsetY(IN void* handle, IN const unsigned int nValue);
  847. /************************************************************************
  848. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetAutoExposureTimeLower(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  849. * @brief 获取曝光下限
  850. * @param void* handle [IN] 相机句柄
  851. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机曝光值下限结构体指针
  852. * @return 成功,返回MV_OK,失败,返回错误码
  853. *
  854. * 可参照接口MV_CC_GetWidth
  855. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetAutoExposureTimeLower(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  856. * @brief Get exposure lower limit
  857. * @param void* handle [IN] Camera Handle
  858. * @param MVCC_INTVALUE* pstValue [IN][OUT] Return pointer of information structure related to camera exposure lower to user
  859. * @return Success, return MV_OK. Failure, return error code
  860. *
  861. * Refer to MV_CC_GetWidth
  862. ************************************************************************/
  863. MVSDKEXPORT_API int __stdcall MV_CC_GetAutoExposureTimeLower(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  864. /************************************************************************
  865. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetAutoExposureTimeLower(IN void* handle, IN const unsigned int nValue);
  866. * @brief 设置曝光值下限
  867. * @param void* handle [IN] 相机句柄
  868. * const unsigned int nValue [IN] 想要设置的曝光值下限
  869. * @return 成功,返回MV_OK,并且相机曝光下限将会更改为相应值,失败,返回错误码
  870. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetAutoExposureTimeLower(IN void* handle, IN const unsigned int nValue);
  871. * @brief Set exposure lower limit
  872. * @param void* handle [IN] Camera Handle
  873. * const unsigned int nValue [IN] Exposure lower to set
  874. * @return Success, return MV_OK, and the camera exposure time lower limit value will change to the corresponding value. Failure, return error code
  875. ************************************************************************/
  876. MVSDKEXPORT_API int __stdcall MV_CC_SetAutoExposureTimeLower(IN void* handle, IN const unsigned int nValue);
  877. /************************************************************************
  878. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetAutoExposureTimeUpper(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  879. * @brief 获取曝光上限
  880. * @param void* handle [IN] 相机句柄
  881. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机曝光值上限结构体指针
  882. * @return 成功,返回MV_OK,失败,返回错误码
  883. *
  884. * 可参照接口MV_CC_GetWidth
  885. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetAutoExposureTimeUpper(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  886. * @brief Get exposure upper limit
  887. * @param void* handle [IN] Camera Handle
  888. * @param MVCC_INTVALUE* pstValue [IN][OUT] Return pointer of information structure related to camera exposure upper to user
  889. * @return Success, return MV_OK. Failure, return error code
  890. *
  891. * Refer to MV_CC_GetWidth
  892. ************************************************************************/
  893. MVSDKEXPORT_API int __stdcall MV_CC_GetAutoExposureTimeUpper(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  894. /************************************************************************
  895. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetAutoExposureTimeUpper(IN void* handle, IN const unsigned int nValue);
  896. * @brief 设置曝光值上限
  897. * @param void* handle [IN] 相机句柄
  898. * const unsigned int nValue [IN] 想要设置的曝光值上限
  899. * @return 成功,返回MV_OK,并且相机曝光上限将会更改为相应值,失败,返回错误码
  900. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetAutoExposureTimeUpper(IN void* handle, IN const unsigned int nValue);
  901. * @brief Set exposure upper limit
  902. * @param void* handle [IN] Camera Handle
  903. * const unsigned int nValue [IN] Exposure upper to set
  904. * @return Success, return MV_OK, and the camera exposure time upper limit value will change to the corresponding value. Failure, return error code
  905. ************************************************************************/
  906. MVSDKEXPORT_API int __stdcall MV_CC_SetAutoExposureTimeUpper(IN void* handle, IN const unsigned int nValue);
  907. /************************************************************************
  908. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetBrightness(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  909. * @brief 获取亮度值
  910. * @param void* handle [IN] 相机句柄
  911. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机亮度结构体指针
  912. * @return 成功,返回MV_OK,失败,返回错误码
  913. *
  914. * 可参照接口MV_CC_GetWidth
  915. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetBrightness(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  916. * @brief Get brightness
  917. * @param void* handle [IN] Camera Handle
  918. * @param MVCC_INTVALUE* pstValue [IN][OUT] Return pointer of information structure related to camera brightness to user
  919. * @return Success, return MV_OK. Failure, return error code
  920. *
  921. * Refer to MV_CC_GetWidth
  922. ************************************************************************/
  923. MVSDKEXPORT_API int __stdcall MV_CC_GetBrightness(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  924. /************************************************************************
  925. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetBrightness(IN void* handle, IN const unsigned int nValue);
  926. * @brief 设置亮度值
  927. * @param void* handle [IN] 相机句柄
  928. * const unsigned int nValue [IN] 想要设置的亮度值
  929. * @return 成功,返回MV_OK,并且相机亮度将会更改为相应值,失败,返回错误码
  930. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetBrightness(IN void* handle, IN const unsigned int nValue);
  931. * @brief Set brightness
  932. * @param void* handle [IN] Camera Handle
  933. * const unsigned int nValue [IN] Brightness upper to set
  934. * @return Success, return MV_OK, and the camera brightness value will change to the corresponding value. Failure, return error code
  935. ************************************************************************/
  936. MVSDKEXPORT_API int __stdcall MV_CC_SetBrightness(IN void* handle, IN const unsigned int nValue);
  937. /************************************************************************
  938. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetFrameRate(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue);
  939. * @brief 获取帧率
  940. * @param void* handle [IN] 相机句柄
  941. * MVCC_FLOATVALUE* pstValue [IN][OUT] 返回给调用者有关相机帧率的信息结构体指针
  942. * 返回的pstValue结构体的意义
  943. * float fCurValue; // 表示相机当前的帧率
  944. * float fMax; // 表示相机允许设置的最大帧率
  945. * float fMin; // 表示相机允许设置的最小帧率
  946. * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码
  947. *
  948. * 其他浮点型结构体参数的接口可参照此接口
  949. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetFrameRate(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue);
  950. * @brief Get Frame Rate
  951. * @param void* handle [IN] Camera Handle
  952. * MVCC_FLOATVALUE* pstValue [IN][OUT] Return pointer of information structure related to camera frame rate to user
  953. * The meaning of returns pstValue structure
  954. * float fCurValue; // Indicates the current frame rate of the camera
  955. * float fMax; // Indicates the maximum frame rate allowed by the camera
  956. * float fMin; // Indicates the minimum frame rate allowed by the camera
  957. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  958. *
  959. * Other interface of Float structure parameters can refer to this interface
  960. ************************************************************************/
  961. MVSDKEXPORT_API int __stdcall MV_CC_GetFrameRate(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue);
  962. /************************************************************************
  963. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetFrameRate(IN void* handle, IN const float fValue);
  964. * @brief 设置帧率
  965. * @param void* handle [IN] 相机句柄
  966. * const float fValue [IN] 想要设置的相机帧率
  967. * @return 成功,返回MV_OK,并且相机帧率将会更改为相应值,失败,返回错误码
  968. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetFrameRate(IN void* handle, IN const float fValue);
  969. * @brief Set frame rate
  970. * @param void* handle [IN] Camera Handle
  971. * const float fValue [IN] Camera frame rate to set
  972. * @return Success, return MV_OK, and camera frame rate will be changed to the corresponding value. Failure, return error code
  973. ************************************************************************/
  974. MVSDKEXPORT_API int __stdcall MV_CC_SetFrameRate(IN void* handle, IN const float fValue);
  975. /************************************************************************
  976. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetGain(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue);
  977. * @brief 获取增益
  978. * @param void* handle [IN] 相机句柄
  979. * MVCC_FLOATVALUE* pstValue [IN][OUT] 返回给调用者有关相机增益的信息结构体指针
  980. * 返回的pstValue结构体的意义
  981. * float fCurValue; // 表示相机当前的帧率
  982. * float fMax; // 表示相机允许设置的最大帧率
  983. * float fMin; // 表示相机允许设置的最小帧率
  984. * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码
  985. *
  986. * 其他浮点型结构体参数的接口可参照此接口
  987. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetGain(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue);
  988. * @brief Get Gain
  989. * @param void* handle [IN] Camera Handle
  990. * MVCC_FLOATVALUE* pstValue [IN][OUT] Return pointer of information structure related to gain to user
  991. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  992. * float fCurValue; // Camera current gain
  993. * float fMax; // The maximum gain camera allowed
  994. * float fMin; // The minimum gain camera allowed
  995. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  996. *
  997. * Other interface of Float structure parameters can refer to this interface
  998. ************************************************************************/
  999. MVSDKEXPORT_API int __stdcall MV_CC_GetGain(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue);
  1000. /************************************************************************
  1001. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetGain(IN void* handle, IN const float fValue);
  1002. * @brief 设置帧率
  1003. * @param void* handle [IN] 相机句柄
  1004. * const float fValue [IN] 想要设置的相机帧率
  1005. * @return 成功,返回MV_OK,并且相机帧率将会更改为相应值,失败,返回错误码
  1006. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetGain(IN void* handle, IN const float fValue);
  1007. * @brief Set Gain
  1008. * @param void* handle [IN] Camera Handle
  1009. * const float fValue [IN] Gain value to set
  1010. * @return Success, return MV_OK, and the camera gain value will change to the corresponding value. Failure, return error code
  1011. ************************************************************************/
  1012. MVSDKEXPORT_API int __stdcall MV_CC_SetGain(IN void* handle, IN const float fValue);
  1013. /************************************************************************
  1014. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetExposureTime(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue);
  1015. * @brief 获取曝光时间
  1016. * @param void* handle [IN] 相机句柄
  1017. * MVCC_FLOATVALUE* pstValue [IN][OUT] 返回给调用者有关相机曝光时间的信息结构体指针
  1018. * 返回的pstValue结构体的意义
  1019. * float fCurValue; // 表示相机当前的帧率
  1020. * float fMax; // 表示相机允许设置的最大帧率
  1021. * float fMin; // 表示相机允许设置的最小帧率
  1022. * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码
  1023. *
  1024. * 其他浮点型结构体参数的接口可参照此接口
  1025. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetExposureTime(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue);
  1026. * @brief Get exposure time
  1027. * @param void* handle [IN] Camera Handle
  1028. * MVCC_FLOATVALUE* pstValue [IN][OUT] Return pointer of information structure related to exposure time to user
  1029. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  1030. * float fCurValue; // Camera current exposure time
  1031. * float fMax; // The maximum exposure time camera allowed
  1032. * float fMin; // The minimum exposure time camera allowed
  1033. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  1034. *
  1035. * Other interface of Float structure parameters can refer to this interface
  1036. ************************************************************************/
  1037. MVSDKEXPORT_API int __stdcall MV_CC_GetExposureTime(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue);
  1038. /************************************************************************
  1039. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetExposureTime(IN void* handle, IN const float fValue);
  1040. * @brief 设置曝光时间
  1041. * @param void* handle [IN] 相机句柄
  1042. * const float fValue [IN] 想要设置的相机帧率
  1043. * @return 成功,返回MV_OK,并且相机帧率将会更改为相应值,失败,返回错误码
  1044. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetExposureTime(IN void* handle, IN const float fValue);
  1045. * @brief Set exposure time
  1046. * @param void* handle [IN] Camera Handle
  1047. * const float fValue [IN] Exposure time to set
  1048. * @return Success, return MV_OK, and the camera exposure time value will change to the corresponding value. Failure, return error code
  1049. ************************************************************************/
  1050. MVSDKEXPORT_API int __stdcall MV_CC_SetExposureTime(IN void* handle, IN const float fValue);
  1051. /************************************************************************
  1052. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetPixelFormat(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1053. * @brief 获取像素格式
  1054. * @param void* handle [IN] 相机句柄
  1055. * MVCC_ENUMVALUE* pstValue [IN][OUT] 返回给调用者的有关像素格式的信息结构体指针
  1056. * 返回的pstValue结构体的意义
  1057. * unsigned int nCurValue; // 相机当前的像素格式,是枚举类型,比如说PixelType_Gvsp_Mono8, 这里获得的是其整型值,具体数值参照PixelType.h的MvGvspPixelType枚举类型
  1058. * unsigned int nSupportedNum; // 相机支持的像素格式的个数
  1059. * unsigned int nSupportValue[MV_MAX_XML_SYMBOLIC_NUM]; // 相机所有支持的像素格式对应的整型值列表,后面要设置像素格式时,参数必须是这个数组中的一种,否则无效
  1060. * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码
  1061. *
  1062. 其他枚举类型参数接口可参照此接口,有关相应参数的枚举类型对应的整型值请查找PixelType.h 和 CameraParams.h中相应的定义
  1063. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetPixelFormat(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1064. * @brief Get Pixel Format
  1065. * @param void* handle [IN] Camera Handle
  1066. * MVCC_ENUMVALUE* pstValue [IN][OUT] Returns the information structure pointer about pixel format for the caller
  1067. * The meaning of returns pstValue structure
  1068. * unsigned int nCurValue; // The current pixel format of the camera, is the enumeration type, such as PixelType_Gvsp_Mono8, here is the integer value, the specific value please refer to MvGvspPixelType enumeration type in PixelType.h
  1069. * unsigned int nSupportedNum; // Number of pixel formats supported by the camera
  1070. * unsigned int nSupportValue[MV_MAX_XML_SYMBOLIC_NUM]; // The integer values list correspond to all supported pixel formats of the camera, followed by when set the pixel format, the parameter must be one of this list, otherwise invalid
  1071. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  1072. *
  1073. Other interface of Enumeration structure parameters can refer to this interface, look for the corresponding definition in PixelType.h and CameraParams.h for the integer values of the enum type parameter
  1074. ************************************************************************/
  1075. MVSDKEXPORT_API int __stdcall MV_CC_GetPixelFormat(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1076. /************************************************************************
  1077. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetPixelFormat(IN void* handle, IN const unsigned int nValue);
  1078. * @brief 设置像素格式
  1079. * @param void* handle [IN] 相机句柄
  1080. * const unsigned int nValue [IN] 要设置的像素格式对应的整型值,调用此接口时可以直接填写枚举值,如MV_CC_SetPixelFormat(m_handle, PixelType_Gvsp_RGB8_Packed);
  1081. * @return 成功,返回MV_OK,并且相机像素格式将会更改为相应值,失败,返回错误码
  1082. *
  1083. * 要设置的枚举类型必须是Get接口返回的nSupportValue[MV_MAX_XML_SYMBOLIC_NUM]中的一种,否则会失败
  1084. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetPixelFormat(IN void* handle, IN const unsigned int nValue);
  1085. * @brief Set Pixel Format
  1086. * @param void* handle [IN] Camera Handle
  1087. * const unsigned int nValue [IN] The corresponding integer value for pixel format to be set, when calling this interface can be directly filled in enumeration values, such as MV_CC_SetPixelFormat(m_handle, PixelType_Gvsp_RGB8_Packed);
  1088. * @return Success, return MV_OK, and the camera pixel format will change to the corresponding value. Failure, return error code
  1089. *
  1090. * Other interface of Enumeration structure parameters can refer to this interface, the enumeration type to be set must be one of the nSupportValue [MV_MAX_XML_SYMBOLIC_NUM] returned by the Get interface, otherwise it will fail
  1091. ************************************************************************/
  1092. MVSDKEXPORT_API int __stdcall MV_CC_SetPixelFormat(IN void* handle, IN const unsigned int nValue);
  1093. /************************************************************************
  1094. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetAcquisitionMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1095. * @brief 获取采集模式
  1096. * @param void* handle [IN] 相机句柄
  1097. * MVCC_ENUMVALUE* pstValue [IN][OUT] 返回给调用者的有关采集模式的信息结构体指针
  1098. * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码
  1099. *
  1100. 可参照接口MV_CC_GetPixelFormat,参考 CameraParam.h 中的 MV_CAM_ACQUISITION_MODE 定义
  1101. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetAcquisitionMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1102. * @brief Get acquisition mode
  1103. * @param void* handle [IN] Handle
  1104. * MVCC_ENUMVALUE* pstValue [IN][OUT] Structure pointer of acquisition mode
  1105. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  1106. *
  1107. Refer to MV_CC_GetPixelFormat and definition of MV_CAM_ACQUISITION_MODE in CameraParam.h
  1108. ************************************************************************/
  1109. MVSDKEXPORT_API int __stdcall MV_CC_GetAcquisitionMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1110. /************************************************************************
  1111. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetAcquisitionMode(IN void* handle, IN const unsigned int nValue);
  1112. * @brief 设置像素格式
  1113. * @param void* handle [IN] 相机句柄
  1114. * const unsigned int nValue [IN] 要设置的采集模式对应的整型值
  1115. * @return 成功,返回MV_OK,并且相机采集模式将会更改为相应值,失败,返回错误码
  1116. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetAcquisitionMode(IN void* handle, IN const unsigned int nValue);
  1117. * @brief Set acquisition mode
  1118. * @param void* handle [IN] Handle
  1119. * const unsigned int nValue [IN] Integer value to set corresponding to acquisition mode
  1120. * @return Success, return MV_OK, and the camera acquisition mode will change to the corresponding value. Failure, return error code
  1121. ************************************************************************/
  1122. MVSDKEXPORT_API int __stdcall MV_CC_SetAcquisitionMode(IN void* handle, IN const unsigned int nValue);
  1123. /************************************************************************
  1124. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetGainMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1125. * @brief 获取增益模式
  1126. * @param void* handle [IN] 相机句柄
  1127. * MVCC_ENUMVALUE* pstValue [IN][OUT] 返回给调用者的有关增益模式的信息结构体指针
  1128. * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码
  1129. *
  1130. 可参照接口MV_CC_GetPixelFormat,参考 CameraParam.h 中的 MV_CAM_GAIN_MODE 定义
  1131. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetGainMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1132. * @brief Get gain mode
  1133. * @param void* handle [IN] Handle
  1134. * MVCC_ENUMVALUE* pstValue [IN][OUT] Structure pointer of gain mode
  1135. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  1136. *
  1137. Refer to MV_CC_GetPixelFormat and definition of MV_CAM_GAIN_MODE in CameraParam.h
  1138. ************************************************************************/
  1139. MVSDKEXPORT_API int __stdcall MV_CC_GetGainMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1140. /************************************************************************
  1141. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetGainMode(IN void* handle, IN const unsigned int nValue);
  1142. * @brief 设置增益模式
  1143. * @param void* handle [IN] 相机句柄
  1144. * const unsigned int nValue [IN] 要设置的增益模式对应的整型值
  1145. * @return 成功,返回MV_OK,并且相机增益模式将会更改为相应值,失败,返回错误码
  1146. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetGainMode(IN void* handle, IN const unsigned int nValue);
  1147. * @brief Set gain mode
  1148. * @param void* handle [IN] Handle
  1149. * const unsigned int nValue [IN] Integer value to set corresponding to gain mode
  1150. * @return Success, return MV_OK, and the camera gain mode will change to the corresponding value. Failure, return error code
  1151. ************************************************************************/
  1152. MVSDKEXPORT_API int __stdcall MV_CC_SetGainMode(IN void* handle, IN const unsigned int nValue);
  1153. /************************************************************************
  1154. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetExposureAutoMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1155. * @brief 获取自动曝光模式
  1156. * @param void* handle [IN] 相机句柄
  1157. * MVCC_ENUMVALUE* pstValue [IN][OUT] 返回给调用者的有关自动曝光模式的信息结构体指针
  1158. * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码
  1159. *
  1160. 可参照接口MV_CC_GetPixelFormat,参考 CameraParam.h 中的 MV_CAM_EXPOSURE_AUTO_MODE 定义
  1161. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetExposureAutoMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1162. * @brief Get auto exposure mode
  1163. * @param void* handle [IN] Handle
  1164. * MVCC_ENUMVALUE* pstValue [IN][OUT] Structure pointer of auto exposure mode
  1165. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  1166. *
  1167. Refer to MV_CC_GetPixelFormat and definition of MV_CAM_EXPOSURE_AUTO_MODE in CameraParam.h
  1168. ************************************************************************/
  1169. MVSDKEXPORT_API int __stdcall MV_CC_GetExposureAutoMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1170. /************************************************************************
  1171. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetExposureAutoMode(IN void* handle, IN const unsigned int nValue);
  1172. * @brief 设置自动曝光模式
  1173. * @param void* handle [IN] 相机句柄
  1174. * const unsigned int nValue [IN] 要设置的自动曝光模式对应的整型值
  1175. * @return 成功,返回MV_OK,并且相机自动曝光模式将会更改为相应值,失败,返回错误码
  1176. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetExposureAutoMode(IN void* handle, IN const unsigned int nValue);
  1177. * @brief Set auto exposure mode
  1178. * @param void* handle [IN] Handle
  1179. * const unsigned int nValue [IN] Integer value to set corresponding to auto exposure mode
  1180. * @return Success, return MV_OK, and the camera auto exposure mode will change to the corresponding value. Failure, return error code
  1181. ************************************************************************/
  1182. MVSDKEXPORT_API int __stdcall MV_CC_SetExposureAutoMode(IN void* handle, IN const unsigned int nValue);
  1183. /************************************************************************
  1184. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetTriggerMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1185. * @brief 获取触发模式
  1186. * @param void* handle [IN] 相机句柄
  1187. * MVCC_ENUMVALUE* pstValue [IN][OUT] 返回给调用者的有关触发模式的信息结构体指针
  1188. * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码
  1189. *
  1190. 可参照接口MV_CC_GetPixelFormat,参考 CameraParam.h 中的 MV_CAM_TRIGGER_MODE 定义
  1191. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetTriggerMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1192. * @brief Get trigger mode
  1193. * @param void* handle [IN] Handle
  1194. * MVCC_ENUMVALUE* pstValue [IN][OUT] Structure pointer of trigger mode
  1195. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  1196. *
  1197. Refer to MV_CC_GetPixelFormat and definition of MV_CAM_TRIGGER_MODE in CameraParam.h
  1198. ************************************************************************/
  1199. MVSDKEXPORT_API int __stdcall MV_CC_GetTriggerMode(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1200. /************************************************************************
  1201. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetTriggerMode(IN void* handle, IN const unsigned int nValue);
  1202. * @brief 设置触发模式
  1203. * @param void* handle [IN] 相机句柄
  1204. * const unsigned int nValue [IN] 要设置的触发模式对应的整型值
  1205. * @return 成功,返回MV_OK,并且相机触发模式将会更改为相应值,失败,返回错误码
  1206. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetTriggerMode(IN void* handle, IN const unsigned int nValue);
  1207. * @brief Set trigger mode
  1208. * @param void* handle [IN] Handle
  1209. * const unsigned int nValue [IN] Integer value to set corresponding to trigger mode
  1210. * @return Success, return MV_OK, and the camera trigger mode will change to the corresponding value. Failure, return error code
  1211. ************************************************************************/
  1212. MVSDKEXPORT_API int __stdcall MV_CC_SetTriggerMode(IN void* handle, IN const unsigned int nValue);
  1213. /************************************************************************
  1214. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetTriggerDelay(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue);
  1215. * @brief 获取触发延时
  1216. * @param void* handle [IN] 相机句柄
  1217. * MVCC_FLOATVALUE* pstValue [IN][OUT] 返回给调用者有关相机触发延时的信息结构体指针
  1218. * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码
  1219. *
  1220. * 可参照接口MV_CC_GetFrameRate
  1221. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetTriggerDelay(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue);
  1222. * @brief Get tigger delay
  1223. * @param void* handle [IN] Handle
  1224. * MVCC_FLOATVALUE* pstValue [IN][OUT] Structure pointer of trigger delay
  1225. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  1226. *
  1227. * Refer to MV_CC_GetFrameRate
  1228. ************************************************************************/
  1229. MVSDKEXPORT_API int __stdcall MV_CC_GetTriggerDelay(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue);
  1230. /************************************************************************
  1231. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetTriggerDelay(IN void* handle, IN const float fValue);
  1232. * @brief 设置触发延时
  1233. * @param void* handle [IN] 相机句柄
  1234. * const float fValue [IN] 想要设置的相机触发延时
  1235. * @return 成功,返回MV_OK,并且相机触发延时将会更改为相应值,失败,返回错误码
  1236. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetTriggerDelay(IN void* handle, IN const float fValue);
  1237. * @brief Set tigger delay
  1238. * @param void* handle [IN] Handle
  1239. * const float fValue [IN] Trigger delay to set
  1240. * @return Success, return MV_OK, and the camera trigger delay will change to the corresponding value. Failure, return error code
  1241. ************************************************************************/
  1242. MVSDKEXPORT_API int __stdcall MV_CC_SetTriggerDelay(IN void* handle, IN const float fValue);
  1243. /************************************************************************
  1244. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetTriggerSource(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1245. * @brief 获取触发源
  1246. * @param void* handle [IN] 相机句柄
  1247. * MVCC_ENUMVALUE* pstValue [IN][OUT] 返回给调用者的有关触发源的信息结构体指针
  1248. * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码
  1249. *
  1250. 可参照接口MV_CC_GetPixelFormat,参考 CameraParam.h 中的 MV_CAM_TRIGGER_SOURCE 定义
  1251. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetTriggerSource(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1252. * @brief Get trigger source
  1253. * @param void* handle [IN] Handle
  1254. * MVCC_ENUMVALUE* pstValue [IN][OUT] Structure pointer of trigger source
  1255. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  1256. *
  1257. Refer to MV_CC_GetPixelFormat and definition of MV_CAM_TRIGGER_SOURCE in CameraParam.h
  1258. ************************************************************************/
  1259. MVSDKEXPORT_API int __stdcall MV_CC_GetTriggerSource(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1260. /************************************************************************
  1261. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetTriggerSource(IN void* handle, IN const unsigned int nValue);
  1262. * @brief 设置触发源
  1263. * @param void* handle [IN] 相机句柄
  1264. * const unsigned int nValue [IN] 要设置的触发源对应的整型值
  1265. * @return 成功,返回MV_OK,并且相机触发源将会更改为相应值,失败,返回错误码
  1266. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetTriggerSource(IN void* handle, IN const unsigned int nValue);
  1267. * @brief Set trigger source
  1268. * @param void* handle [IN] Handle
  1269. * const unsigned int nValue [IN] Integer value to set corresponding to trigger source
  1270. * @return Success, return MV_OK, and the camera trigger source will change to the corresponding value. Failure, return error code
  1271. ************************************************************************/
  1272. MVSDKEXPORT_API int __stdcall MV_CC_SetTriggerSource(IN void* handle, IN const unsigned int nValue);
  1273. /************************************************************************
  1274. * @fn MVSDKEXPORT_API int __stdcall MV_CC_TriggerSoftwareExecute(IN void* handle);
  1275. * @brief 软触发一次(接口仅在已选择的触发源为软件触发时有效)
  1276. * @param void* handle [IN] 相机句柄
  1277. * @return 成功,返回MV_OK, 失败,返回错误码
  1278. * @fn MVSDKEXPORT_API int __stdcall MV_CC_TriggerSoftwareExecute(IN void* handle);
  1279. * @brief Execute software trigger once (this interface only valid when the trigger source is set to software)
  1280. * @param void* handle [IN] Handle
  1281. * @return Success, return MV_OK. Failure, return error code
  1282. ************************************************************************/
  1283. MVSDKEXPORT_API int __stdcall MV_CC_TriggerSoftwareExecute(IN void* handle);
  1284. /************************************************************************
  1285. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetGammaSelector(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1286. * @brief 获取Gamma类型
  1287. * @param void* handle [IN] 相机句柄
  1288. * MVCC_ENUMVALUE* pstValue [IN][OUT] 返回给调用者的有关Gamma类型的信息结构体指针
  1289. * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码
  1290. *
  1291. 可参照接口MV_CC_GetPixelFormat,参考 CameraParam.h 中的 MV_CAM_GAMMA_SELECTOR 定义
  1292. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetGammaSelector(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1293. * @brief Get Gamma mode
  1294. * @param void* handle [IN] Handle
  1295. * MVCC_ENUMVALUE* pstValue [IN][OUT] Structure pointer of gamma mode
  1296. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  1297. *
  1298. Refer to MV_CC_GetPixelFormat and definition of MV_CAM_GAMMA_SELECTOR in CameraParam.h
  1299. ************************************************************************/
  1300. MVSDKEXPORT_API int __stdcall MV_CC_GetGammaSelector(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1301. /************************************************************************
  1302. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetGammaSelector(IN void* handle, IN const unsigned int nValue);
  1303. * @brief 设置Gamma类型
  1304. * @param void* handle [IN] 相机句柄
  1305. * const unsigned int nValue [IN] 要设置的Gamma类型对应的整型值
  1306. * @return 成功,返回MV_OK,并且相机Gamma类型将会更改为相应值,失败,返回错误码
  1307. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetGammaSelector(IN void* handle, IN const unsigned int nValue);
  1308. * @brief Set Gamma mode
  1309. * @param void* handle [IN] Handle
  1310. * const unsigned int nValue [IN] Integer value to set corresponding to gamma mode
  1311. * @return Success, return MV_OK, and the camera gamma mode will change to the corresponding value. Failure, return error code
  1312. ************************************************************************/
  1313. MVSDKEXPORT_API int __stdcall MV_CC_SetGammaSelector(IN void* handle, IN const unsigned int nValue);
  1314. /************************************************************************
  1315. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetGamma(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue);
  1316. * @brief 获取Gamma值
  1317. * @param void* handle [IN] 相机句柄
  1318. * MVCC_FLOATVALUE* pstValue [IN][OUT] 返回给调用者有关相机Gamma值的信息结构体指针
  1319. * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码
  1320. *
  1321. * 可参照接口MV_CC_GetFrameRate
  1322. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetGamma(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue);
  1323. * @brief Get Gamma value
  1324. * @param void* handle [IN] Handle
  1325. * MVCC_FLOATVALUE* pstValue [IN][OUT] Structure pointer of gamma value
  1326. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  1327. *
  1328. * Refer to MV_CC_GetFrameRate
  1329. ************************************************************************/
  1330. MVSDKEXPORT_API int __stdcall MV_CC_GetGamma(IN void* handle, IN OUT MVCC_FLOATVALUE* pstValue);
  1331. /************************************************************************
  1332. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetGamma(IN void* handle, IN const float fValue);
  1333. * @brief 设置Gamma值
  1334. * @param void* handle [IN] 相机句柄
  1335. * const float fValue [IN] 想要设置的相机Gamma值
  1336. * @return 成功,返回MV_OK,并且相机Gamma值将会更改为相应值,失败,返回错误码
  1337. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetGamma(IN void* handle, IN const float fValue);
  1338. * @brief Set Gamma value
  1339. * @param void* handle [IN] Handle
  1340. * const float fValue [IN] Gamma value to set
  1341. * @return Success, return MV_OK, and the camera gamma value will change to the corresponding value. Failure, return error code
  1342. ************************************************************************/
  1343. MVSDKEXPORT_API int __stdcall MV_CC_SetGamma(IN void* handle, IN const float fValue);
  1344. /************************************************************************
  1345. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetSharpness(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1346. * @brief 获取锐度
  1347. * @param void* handle [IN] 相机句柄
  1348. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机锐度结构体指针
  1349. * @return 成功,返回MV_OK,失败,返回错误码
  1350. *
  1351. * 可参照接口MV_CC_GetWidth
  1352. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetSharpness(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1353. * @brief Get sharpness
  1354. * @param void* handle [IN] Handle
  1355. * @param MVCC_INTVALUE* pstValue [IN][OUT] Structure pointer of sharpness
  1356. * @return Success, return MV_OK. Failure, return error code
  1357. *
  1358. * Refer to MV_CC_GetWidth
  1359. ************************************************************************/
  1360. MVSDKEXPORT_API int __stdcall MV_CC_GetSharpness(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1361. /************************************************************************
  1362. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetSharpness(IN void* handle, IN const unsigned int nValue);
  1363. * @brief 设置锐度
  1364. * @param void* handle [IN] 相机句柄
  1365. * const unsigned int nValue [IN] 想要设置的锐度
  1366. * @return 成功,返回MV_OK,并且相机锐度将会更改为相应值,失败,返回错误码
  1367. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetSharpness(IN void* handle, IN const unsigned int nValue);
  1368. * @brief Set sharpness
  1369. * @param void* handle [IN] Handle
  1370. * const unsigned int nValue [IN] Sharpness to set
  1371. * @return Success, return MV_OK, and the camera sharpness will change to the corresponding value. Failure, return error code
  1372. ************************************************************************/
  1373. MVSDKEXPORT_API int __stdcall MV_CC_SetSharpness(IN void* handle, IN const unsigned int nValue);
  1374. /************************************************************************
  1375. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetHue(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1376. * @brief 获取灰度
  1377. * @param void* handle [IN] 相机句柄
  1378. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机灰度结构体指针
  1379. * @return 成功,返回MV_OK,失败,返回错误码
  1380. *
  1381. * 可参照接口MV_CC_GetWidth
  1382. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetHue(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1383. * @brief Get Hue
  1384. * @param void* handle [IN] Handle
  1385. * @param MVCC_INTVALUE* pstValue [IN][OUT] Structure pointer of Hue
  1386. * @return Success, return MV_OK. Failure, return error code
  1387. *
  1388. * Refer to MV_CC_GetWidth
  1389. ************************************************************************/
  1390. MVSDKEXPORT_API int __stdcall MV_CC_GetHue(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1391. /************************************************************************
  1392. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetHue(IN void* handle, IN const unsigned int nValue);
  1393. * @brief 设置灰度
  1394. * @param void* handle [IN] 相机句柄
  1395. * const unsigned int nValue [IN] 想要设置的灰度
  1396. * @return 成功,返回MV_OK,并且相机灰度将会更改为相应值,失败,返回错误码
  1397. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetHue(IN void* handle, IN const unsigned int nValue);
  1398. * @brief Set Hue
  1399. * @param void* handle [IN] Handle
  1400. * const unsigned int nValue [IN] Hue to set
  1401. * @return Success, return MV_OK, and the camera Hue will change to the corresponding value. Failure, return error code
  1402. ************************************************************************/
  1403. MVSDKEXPORT_API int __stdcall MV_CC_SetHue(IN void* handle, IN const unsigned int nValue);
  1404. /************************************************************************
  1405. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetSaturation(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1406. * @brief 获取饱和度
  1407. * @param void* handle [IN] 相机句柄
  1408. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机饱和度结构体指针
  1409. * @return 成功,返回MV_OK,失败,返回错误码
  1410. *
  1411. * 可参照接口MV_CC_GetWidth
  1412. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetSaturation(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1413. * @brief Get Saturation
  1414. * @param void* handle [IN] Handle
  1415. * @param MVCC_INTVALUE* pstValue [IN][OUT] Structure pointer of Saturation
  1416. * @return Success, return MV_OK. Failure, return error code
  1417. *
  1418. * Refer to MV_CC_GetWidth
  1419. ************************************************************************/
  1420. MVSDKEXPORT_API int __stdcall MV_CC_GetSaturation(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1421. /************************************************************************
  1422. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetSaturation(IN void* handle, IN const unsigned int nValue);
  1423. * @brief 设置饱和度
  1424. * @param void* handle [IN] 相机句柄
  1425. * const unsigned int nValue [IN] 想要设置的饱和度
  1426. * @return 成功,返回MV_OK,并且相机饱和度将会更改为相应值,失败,返回错误码
  1427. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetSaturation(IN void* handle, IN const unsigned int nValue);
  1428. * @brief Set Saturation
  1429. * @param void* handle [IN] Handle
  1430. * const unsigned int nValue [IN] Saturation to set
  1431. * @return Success, return MV_OK, and the camera Saturation will change to the corresponding value. Failure, return error code
  1432. ************************************************************************/
  1433. MVSDKEXPORT_API int __stdcall MV_CC_SetSaturation(IN void* handle, IN const unsigned int nValue);
  1434. /************************************************************************
  1435. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetBalanceWhiteAuto(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1436. * @brief 获取自动白平衡
  1437. * @param void* handle [IN] 相机句柄
  1438. * MVCC_ENUMVALUE* pstValue [IN][OUT] 返回给调用者的有关自动白平衡的信息结构体指针
  1439. * @return 成功,返回MV_OK,并获得相应参数信息的结构体, 失败, 返回错误码
  1440. *
  1441. 可参照接口MV_CC_GetPixelFormat,参考 CameraParam.h 中的 MV_CAM_BALANCEWHITE_AUTO 定义
  1442. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetBalanceWhiteAuto(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1443. * @brief Get Auto white balance
  1444. * @param void* handle [IN] Handle
  1445. * MVCC_ENUMVALUE* pstValue [IN][OUT] Structure pointer of auto white balance
  1446. * @return Success, return MV_OK, and get the structure of the corresponding parameters. Failure, return error code
  1447. *
  1448. Refer to MV_CC_GetPixelFormat and definition of MV_CAM_BALANCEWHITE_AUTO in CameraParam.h
  1449. ************************************************************************/
  1450. MVSDKEXPORT_API int __stdcall MV_CC_GetBalanceWhiteAuto(IN void* handle, IN OUT MVCC_ENUMVALUE* pstValue);
  1451. /************************************************************************
  1452. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetBalanceWhiteAuto(IN void* handle, IN const unsigned int nValue);
  1453. * @brief 设置自动白平衡
  1454. * @param void* handle [IN] 相机句柄
  1455. * const unsigned int nValue [IN] 要设置的自动白平衡对应的整型值
  1456. * @return 成功,返回MV_OK,并且相机自动白平衡将会更改为相应值,失败,返回错误码
  1457. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetBalanceWhiteAuto(IN void* handle, IN const unsigned int nValue);
  1458. * @brief Set Auto white balance
  1459. * @param void* handle [IN] Handle
  1460. * const unsigned int nValue [IN] Integer value to set corresponding to auto white balance
  1461. * @return Success, return MV_OK, and the camera auto white balance will change to the corresponding value. Failure, return error code
  1462. ************************************************************************/
  1463. MVSDKEXPORT_API int __stdcall MV_CC_SetBalanceWhiteAuto(IN void* handle, IN const unsigned int nValue);
  1464. /************************************************************************
  1465. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetBalanceRatioRed(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1466. * @brief 获取白平衡 红
  1467. * @param void* handle [IN] 相机句柄
  1468. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机白平衡 红结构体指针
  1469. * @return 成功,返回MV_OK,失败,返回错误码
  1470. *
  1471. * 可参照接口MV_CC_GetWidth
  1472. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetBalanceRatioRed(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1473. * @brief Get white balance red
  1474. * @param void* handle [IN] Handle
  1475. * @param MVCC_INTVALUE* pstValue [IN][OUT] Structure pointer of white balance red
  1476. * @return Success, return MV_OK. Failure, return error code
  1477. *
  1478. * Refer to MV_CC_GetWidth
  1479. ************************************************************************/
  1480. MVSDKEXPORT_API int __stdcall MV_CC_GetBalanceRatioRed(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1481. /************************************************************************
  1482. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetBalanceRatioRed(IN void* handle, IN const unsigned int nValue);
  1483. * @brief 设置白平衡 红
  1484. * @param void* handle [IN] 相机句柄
  1485. * const unsigned int nValue [IN] 想要设置的白平衡 红
  1486. * @return 成功,返回MV_OK,并且相机白平衡 红将会更改为相应值,失败,返回错误码
  1487. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetBalanceRatioRed(IN void* handle, IN const unsigned int nValue);
  1488. * @brief Set white balance red
  1489. * @param void* handle [IN] Handle
  1490. * const unsigned int nValue [IN] White balance red to set
  1491. * @return Success, return MV_OK, and the camera white balance red will change to the corresponding value. Failure, return error code
  1492. ************************************************************************/
  1493. MVSDKEXPORT_API int __stdcall MV_CC_SetBalanceRatioRed(IN void* handle, IN const unsigned int nValue);
  1494. /************************************************************************
  1495. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetBalanceRatioGreen(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1496. * @brief 获取白平衡 绿
  1497. * @param void* handle [IN] 相机句柄
  1498. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机白平衡 绿结构体指针
  1499. * @return 成功,返回MV_OK,失败,返回错误码
  1500. *
  1501. * 可参照接口MV_CC_GetWidth
  1502. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetBalanceRatioGreen(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1503. * @brief Get white balance green
  1504. * @param void* handle [IN] Handle
  1505. * @param MVCC_INTVALUE* pstValue [IN][OUT] Structure pointer of white balance green
  1506. * @return Success, return MV_OK. Failure, return error code
  1507. *
  1508. * Refer to MV_CC_GetWidth
  1509. ************************************************************************/
  1510. MVSDKEXPORT_API int __stdcall MV_CC_GetBalanceRatioGreen(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1511. /************************************************************************
  1512. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetBalanceRatioGreen(IN void* handle, IN const unsigned int nValue);
  1513. * @brief 设置白平衡 绿
  1514. * @param void* handle [IN] 相机句柄
  1515. * const unsigned int nValue [IN] 想要设置的白平衡 绿
  1516. * @return 成功,返回MV_OK,并且相机白平衡 绿将会更改为相应值,失败,返回错误码
  1517. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetBalanceRatioGreen(IN void* handle, IN const unsigned int nValue);
  1518. * @brief Set white balance green
  1519. * @param void* handle [IN] Handle
  1520. * const unsigned int nValue [IN] White balance green to set
  1521. * @return Success, return MV_OK, and the camera white balance green will change to the corresponding value. Failure, return error code
  1522. ************************************************************************/
  1523. MVSDKEXPORT_API int __stdcall MV_CC_SetBalanceRatioGreen(IN void* handle, IN const unsigned int nValue);
  1524. /************************************************************************
  1525. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetBalanceRatioBlue(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1526. * @brief 获取白平衡 蓝
  1527. * @param void* handle [IN] 相机句柄
  1528. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机白平衡 蓝结构体指针
  1529. * @return 成功,返回MV_OK,失败,返回错误码
  1530. *
  1531. * 可参照接口MV_CC_GetWidth
  1532. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetBalanceRatioBlue(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1533. * @brief Get white balance blue
  1534. * @param void* handle [IN] Handle
  1535. * @param MVCC_INTVALUE* pstValue [IN][OUT] Structure pointer of white balance blue
  1536. * @return Success, return MV_OK. Failure, return error code
  1537. *
  1538. * Refer to MV_CC_GetWidth
  1539. ************************************************************************/
  1540. MVSDKEXPORT_API int __stdcall MV_CC_GetBalanceRatioBlue(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1541. /************************************************************************
  1542. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetBalanceRatioBlue(IN void* handle, IN const unsigned int nValue);
  1543. * @brief 设置白平衡 蓝
  1544. * @param void* handle [IN] 相机句柄
  1545. * const unsigned int nValue [IN] 想要设置的白平衡 蓝
  1546. * @return 成功,返回MV_OK,并且相机白平衡 蓝将会更改为相应值,失败,返回错误码
  1547. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetBalanceRatioBlue(IN void* handle, IN const unsigned int nValue);
  1548. * @brief Set white balance blue
  1549. * @param void* handle [IN] Handle
  1550. * const unsigned int nValue [IN] White balance blue to set
  1551. * @return Success, return MV_OK, and the camera white balance blue will change to the corresponding value. Failure, return error code
  1552. ************************************************************************/
  1553. MVSDKEXPORT_API int __stdcall MV_CC_SetBalanceRatioBlue(IN void* handle, IN const unsigned int nValue);
  1554. /************************************************************************
  1555. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetFrameSpecInfoAbility(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1556. * @brief 获取水印信息内包含的信息类型
  1557. * @param void* handle [IN] 相机句柄
  1558. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机水印信息内包含的信息类型结构体指针
  1559. * @return 成功,返回MV_OK,失败,返回错误码
  1560. *
  1561. * 可参照接口MV_CC_GetWidth
  1562. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetFrameSpecInfoAbility(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1563. * @brief Get information type included by frame stamp
  1564. * @param void* handle [IN] Handle
  1565. * @param MVCC_INTVALUE* pstValue [IN][OUT] Structure pointer of information type included by frame stamp
  1566. * @return Success, return MV_OK. Failure, return error code
  1567. *
  1568. * Refer to MV_CC_GetWidth
  1569. ************************************************************************/
  1570. MVSDKEXPORT_API int __stdcall MV_CC_GetFrameSpecInfoAbility(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1571. /************************************************************************
  1572. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetFrameSpecInfoAbility(IN void* handle, IN const unsigned int nValue);
  1573. * @brief 设置水印信息内包含的信息类型
  1574. * @param void* handle [IN] 相机句柄
  1575. * const unsigned int nValue [IN] 想要设置的水印信息内包含的信息类型
  1576. * @return 成功,返回MV_OK,并且相机水印信息内包含的信息类型会更改为相应值,失败,返回错误码
  1577. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetFrameSpecInfoAbility(IN void* handle, IN const unsigned int nValue);
  1578. * @brief Set information type included by frame stamp
  1579. * @param void* handle [IN] Handle
  1580. * const unsigned int nValue [IN] Information type included by frame stamp to set
  1581. * @return Success, return MV_OK, and the camera information type included by frame stamp will change to the corresponding value. Failure, return error code
  1582. ************************************************************************/
  1583. MVSDKEXPORT_API int __stdcall MV_CC_SetFrameSpecInfoAbility(IN void* handle, IN const unsigned int nValue);
  1584. /************************************************************************
  1585. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetDeviceUserID(IN void* handle, IN OUT MVCC_STRINGVALUE* pstValue);
  1586. * @brief 获取设备自定义名字
  1587. * @param void* handle [IN] 相机句柄
  1588. * MVCC_STRINGVALUE* pstValue [IN OUT] 返回给调用者有关相机名字结构体指针
  1589. * @return 成功,返回MV_OK,并且获取到相机的自定义名字,失败,返回错误码
  1590. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetDeviceUserID(IN void* handle, IN OUT MVCC_STRINGVALUE* pstValue);
  1591. * @brief Get device user defined name
  1592. * @param void* handle [IN] Handle
  1593. * MVCC_STRINGVALUE* pstValue [IN OUT] Structure pointer of device name
  1594. * @return Success, return MV_OK, and get the camera user defined name. Failure, return error code
  1595. ************************************************************************/
  1596. MVSDKEXPORT_API int __stdcall MV_CC_GetDeviceUserID(IN void* handle, IN OUT MVCC_STRINGVALUE* pstValue);
  1597. /************************************************************************
  1598. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetDeviceUserID(IN void* handle, IN const char* chValue);
  1599. * @brief 设置设备自定义名字
  1600. * @param void* handle [IN] 相机句柄
  1601. * IN const char* chValue [IN] 设备名字
  1602. * @return 成功,返回MV_OK,并且设置设备自定义名字,失败,返回错误码
  1603. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetDeviceUserID(IN void* handle, IN const char* chValue);
  1604. * @brief Set device user defined name
  1605. * @param void* handle [IN] Handle
  1606. * IN const char* chValue [IN] Device name
  1607. * @return Success, return MV_OK, and set the camera user defined name. Failure, return error code
  1608. ************************************************************************/
  1609. MVSDKEXPORT_API int __stdcall MV_CC_SetDeviceUserID(IN void* handle, IN const char* chValue);
  1610. /************************************************************************
  1611. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetBurstFrameCount(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1612. * @brief 获取一次触发的帧数
  1613. * @param void* handle [IN] 相机句柄
  1614. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机一次触发的帧数结构体指针
  1615. * @return 成功,返回MV_OK,失败,返回错误码
  1616. *
  1617. * 可参照接口MV_CC_GetWidth
  1618. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetBurstFrameCount(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1619. * @brief Get frame number trigger by once
  1620. * @param void* handle [IN] Handle
  1621. * @param MVCC_INTVALUE* pstValue [IN][OUT] Structure pointer of frame number trigger by once
  1622. * @return Success, return MV_OK. Failure, return error code
  1623. *
  1624. * Refer to MV_CC_GetWidth
  1625. ************************************************************************/
  1626. MVSDKEXPORT_API int __stdcall MV_CC_GetBurstFrameCount(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1627. /************************************************************************
  1628. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetBurstFrameCount(IN void* handle, IN const unsigned int nValue);
  1629. * @brief 设置一次触发的帧数
  1630. * @param void* handle [IN] 相机句柄
  1631. * const unsigned int nValue [IN] 想要设置的一次触发的帧数
  1632. * @return 成功,返回MV_OK,并且相机一次触发的帧数会更改为相应值,失败,返回错误码
  1633. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetBurstFrameCount(IN void* handle, IN const unsigned int nValue);
  1634. * @brief Set frame number trigger by once
  1635. * @param void* handle [IN] Handle
  1636. * const unsigned int nValue [IN] Frame number trigger by once to set
  1637. * @return Success, return MV_OK, and the camera frame number trigger by once will change to the corresponding value. Failure, return error code
  1638. ************************************************************************/
  1639. MVSDKEXPORT_API int __stdcall MV_CC_SetBurstFrameCount(IN void* handle, IN const unsigned int nValue);
  1640. /************************************************************************
  1641. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetAcquisitionLineRate(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1642. * @brief 获取行频
  1643. * @param void* handle [IN] 相机句柄
  1644. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机行频结构体指针
  1645. * @return 成功,返回MV_OK,失败,返回错误码
  1646. *
  1647. * 可参照接口MV_CC_GetWidth
  1648. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetAcquisitionLineRate(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1649. * @brief Get line rate
  1650. * @param void* handle [IN] Handle
  1651. * @param MVCC_INTVALUE* pstValue [IN][OUT] Structure pointer of line rate
  1652. * @return Success, return MV_OK. Failure, return error code
  1653. *
  1654. * Refer to MV_CC_GetWidth
  1655. ************************************************************************/
  1656. MVSDKEXPORT_API int __stdcall MV_CC_GetAcquisitionLineRate(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1657. /************************************************************************
  1658. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetAcquisitionLineRate(IN void* handle, IN const unsigned int nValue);
  1659. * @brief 设置行频
  1660. * @param void* handle [IN] 相机句柄
  1661. * const unsigned int nValue [IN] 想要设置的行频
  1662. * @return 成功,返回MV_OK,并且相机行频会更改为相应值,失败,返回错误码
  1663. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetAcquisitionLineRate(IN void* handle, IN const unsigned int nValue);
  1664. * @brief Set line rate
  1665. * @param void* handle [IN] Handle
  1666. * const unsigned int nValue [IN] Line rate to set
  1667. * @return Success, return MV_OK, and the camera line rate will change to the corresponding value. Failure, return error code
  1668. ************************************************************************/
  1669. MVSDKEXPORT_API int __stdcall MV_CC_SetAcquisitionLineRate(IN void* handle, IN const unsigned int nValue);
  1670. /************************************************************************
  1671. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetHeartBeatTimeout(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1672. * @brief 获取心跳信息
  1673. * @param void* handle [IN] 相机句柄
  1674. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机心跳信息结构体指针
  1675. * @return 成功,返回MV_OK,失败,返回错误码
  1676. *
  1677. * 可参照接口MV_CC_GetWidth
  1678. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetHeartBeatTimeout(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1679. * @brief Get heartbeat information
  1680. * @param void* handle [IN] Handle
  1681. * @param MVCC_INTVALUE* pstValue [IN][OUT] Structure pointer of heartbeat information
  1682. * @return Success, return MV_OK. Failure, return error code
  1683. *
  1684. * Refer to MV_CC_GetWidth
  1685. ************************************************************************/
  1686. MVSDKEXPORT_API int __stdcall MV_CC_GetHeartBeatTimeout(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1687. /************************************************************************
  1688. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetHeartBeatTimeout(IN void* handle, IN const unsigned int nValue);
  1689. * @brief 设置心跳信息
  1690. * @param void* handle [IN] 相机句柄
  1691. * const unsigned int nValue [IN] 想要设置的心跳信息
  1692. * @return 成功,返回MV_OK,并且相机心跳信息会更改为相应值,失败,返回错误码
  1693. * @fn MVSDKEXPORT_API int __stdcall MV_CC_SetHeartBeatTimeout(IN void* handle, IN const unsigned int nValue);
  1694. * @brief Set heartbeat information
  1695. * @param void* handle [IN] Handle
  1696. * const unsigned int nValue [IN] Heartbeat information to set
  1697. * @return Success, return MV_OK, and the camera heartbeat information will change to the corresponding value. Failure, return error code
  1698. ************************************************************************/
  1699. MVSDKEXPORT_API int __stdcall MV_CC_SetHeartBeatTimeout(IN void* handle, IN const unsigned int nValue);
  1700. /************************************************************************/
  1701. /* 设备升级 和 寄存器读写 和异常、事件回调 */
  1702. /* Device upgrade, register read and write and exception callback */
  1703. /************************************************************************/
  1704. // 设备本地升级
  1705. // Device Local Upgrade
  1706. /************************************************************************
  1707. * @fn MVSDKEXPORT_API int __stdcall MV_CC_LocalUpgrade(IN void* handle,
  1708. const void *pFilePathName);
  1709. * @brief 设备本地升级
  1710. * @param void* handle [IN] 相机句柄
  1711. * @param void *pFilePathName [IN] 文件名
  1712. * @return 成功,返回MV_OK,失败,返回错误码
  1713. * @fn MVSDKEXPORT_API int __stdcall MV_CC_LocalUpgrade(IN void* handle,
  1714. const void *pFilePathName);
  1715. * @brief Device Local Upgrade
  1716. * @param void* handle [IN] Camera handle
  1717. * @param void *pFilePathName [IN] File name
  1718. * @return Success, return MV_OK. Failure, return error code
  1719. ************************************************************************/
  1720. MVSDKEXPORT_API int __stdcall MV_CC_LocalUpgrade(IN void* handle, const void *pFilePathName);
  1721. /************************************************************************
  1722. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetUpgradeProcess(IN void* handle,
  1723. unsigned int* pnProcess);
  1724. * @brief 获取升级进度
  1725. * @param void* handle [IN] 相机句柄
  1726. * @param unsigned int* pnProcess [OUT] 进度接收地址
  1727. * @return 成功,返回MV_OK,失败,返回错误码
  1728. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetUpgradeProcess(IN void* handle,
  1729. unsigned int* pnProcess);
  1730. * @brief Get Upgrade Progress
  1731. * @param void* handle [IN] Camera handle
  1732. * @param unsigned int* pnProcess [OUT] Progress receiving address
  1733. * @return Success, return MV_OK. Failure, return error code
  1734. ************************************************************************/
  1735. MVSDKEXPORT_API int __stdcall MV_CC_GetUpgradeProcess(IN void* handle, unsigned int* pnProcess);
  1736. /************************************************************************
  1737. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetOptimalPacketSize(IN void* handle);
  1738. * @brief 获取最佳的packet size,该接口目前只支持GigE相机
  1739. * @param void* handle [IN] 相机句柄
  1740. * @return 最佳packetsize
  1741. * @fn MVSDKEXPORT_API int __stdcall MV_CC_GetOptimalPacketSize(IN void* handle);
  1742. * @brief Get the optimal Packet Size, Only support GigE Camera
  1743. * @param void* handle [IN] Camera handle
  1744. * @return Optimal packetsize
  1745. ************************************************************************/
  1746. MVSDKEXPORT_API int __stdcall MV_CC_GetOptimalPacketSize(IN void* handle);
  1747. /************************************************************************
  1748. * @fn MV_CC_ReadMemory
  1749. * @brief 读内存
  1750. * @param handle:设备句柄
  1751. * @param pBuffer:作为返回值使用,保存读到的内存值(内存值是按照大端模式存储的)
  1752. * @param nAddress:待读取的内存地址,该地址可以从设备的Camera.xml文件中获取,形如xxx_RegAddr的xml节点值
  1753. (设备的Camera.xml文件会在设备打开之后自动生成在应用程序的当前目录中)
  1754. * @param nLength:待读取的内存长度
  1755. * @return 见返回错误码
  1756. * @fn MV_CC_ReadMemory
  1757. * @brief Read Memory
  1758. * @param handle: Device Handle
  1759. * @param pBuffer: Used as a return value, save the read-in memory value ( Memory value is stored in accordance with the big end model)
  1760. * @param nAddress: Memory address to be read, which can be obtained from the Camera.xml file of the device, the form xml node value of xxx_RegAddr
  1761. (Camera.xml file of device is automatically generated in the application's current directory after the device is opened)
  1762. * @param nLength: Length of the memory to be read
  1763. * @return Refer to the return error code
  1764. *************************************************************************/
  1765. MVSDKEXPORT_API int __stdcall MV_CC_ReadMemory(IN void* handle , void *pBuffer, int64_t nAddress, int64_t nLength);
  1766. /************************************************************************
  1767. * @fn MV_CC_WriteMemory
  1768. * @brief 写内存
  1769. * @param handle:设备句柄
  1770. * @param pBuffer:待写入的内存值(注意内存值要按照大端模式存储)
  1771. * @param nAddress:待写入的内存地址,该地址可以从设备的Camera.xml文件中获取,形如xxx_RegAddr的xml节点值
  1772. (设备的Camera.xml文件会在设备打开之后自动生成在应用程序的当前目录中)
  1773. * @param nLength:待写入的内存长度
  1774. * @return 见返回错误码
  1775. * @fn MV_CC_WriteMemory
  1776. * @brief Write Memory
  1777. * @param handle: Device Handle
  1778. * @param pBuffer: Memory value to be written ( Note the memory value to be stored in accordance with the big end model)
  1779. * @param nAddress: Memory address to be written, which can be obtained from the Camera.xml file of the device, the form xml node value of xxx_RegAddr
  1780. (Camera.xml file of device is automatically generated in the application's current directory after the device is opened)
  1781. * @param nLength: Length of the memory to be written
  1782. * @return Refer to the return error code
  1783. ************************************************************************/
  1784. MVSDKEXPORT_API int __stdcall MV_CC_WriteMemory(IN void* handle , const void *pBuffer, int64_t nAddress, int64_t nLength);
  1785. // 注册异常消息回调,在打开设备之后调用
  1786. // Register exception message callback, call after open device
  1787. /************************************************************************
  1788. * @fn MV_CC_RegisterExceptionCallBack
  1789. * @brief 注册异常消息回调,在打开设备之后调用
  1790. * @param handle:设备句柄
  1791. * @param cbException [IN] 异常回调函数指针
  1792. * @param pUser [IN] 用户自定义变量
  1793. * @return 见返回错误码
  1794. * @fn MV_CC_RegisterExceptionCallBack
  1795. * @brief Register Exception Message CallBack, call after open device
  1796. * @param handle: Device handle
  1797. * @param cbException [IN] Exception Message CallBack Function Pointer
  1798. * @param pUser [IN] User defined variable
  1799. * @return Refer to error code
  1800. ************************************************************************/
  1801. MVSDKEXPORT_API int __stdcall MV_CC_RegisterExceptionCallBack(IN void* handle, void(__stdcall* cbException)(unsigned int nMsgType, void* pUser),void* pUser);
  1802. /************************************************************************
  1803. * @fn MV_CC_RegisterAllEventCallBack
  1804. * @brief 注册全部事件回调,在打开设备之后调用,只支持GIGE
  1805. * @param handle:设备句柄
  1806. * @param cbEvent [IN] 异常回调函数指针
  1807. * @param pUser [IN] 用户自定义变量
  1808. * @return 见返回错误码
  1809. * @fn MV_CC_RegisterEventCallBack
  1810. * @brief Register event callback, which is called after the device is opened
  1811. * @param handle: Device handel
  1812. * @param cbEvent [IN] Exception CallBack Function Pointer
  1813. * @param pUser [IN] User defined variable
  1814. * @return Refer to error code
  1815. ************************************************************************/
  1816. MVSDKEXPORT_API int __stdcall MV_CC_RegisterAllEventCallBack(void* handle,void(__stdcall* cbEvent)(MV_EVENT_OUT_INFO * pEventInfo, void* pUser),void* pUser);
  1817. /************************************************************************
  1818. * @fn MV_CC_RegisterEventCallBackEx
  1819. * @brief 注册单个事件回调,在打开设备之后调用,只支持GIGE
  1820. * @param handle:设备句柄
  1821. * @param pEventName [IN] 事件名称
  1822. * @param cbEvent [IN] 异常回调函数指针
  1823. * @param pUser [IN] 用户自定义变量
  1824. * @return 见返回错误码
  1825. ************************************************************************/
  1826. MVSDKEXPORT_API int __stdcall MV_CC_RegisterEventCallBackEx(void* handle, const char* pEventName,void(__stdcall* cbEvent)(MV_EVENT_OUT_INFO * pEventInfo, void* pUser),void* pUser);
  1827. /************************************************************************/
  1828. /* GigEVision 设备独有的接口 */
  1829. /* GigEVision device specific interface */
  1830. /************************************************************************/
  1831. /************************************************************************
  1832. * @fn MV_GIGE_ForceIpEx
  1833. * @brief 强制IP
  1834. * @param handle:设备句柄
  1835. * @param nIP [IN] 设置的IP
  1836. * @param nSubNetMask [IN] 子网掩码
  1837. * @param nDefaultGateWay [IN] 默认网关
  1838. * @return 见返回错误码
  1839. * @fn MV_GIGE_ForceIpEx
  1840. * @brief Force IP
  1841. * @param handle: Device handel
  1842. * @param nIP [IN] IP to set
  1843. * @param nSubNetMask [IN] Subnet mask
  1844. * @param nDefaultGateWay [IN] Default gateway
  1845. * @return Refer to error code
  1846. ************************************************************************/
  1847. MVSDKEXPORT_API int __stdcall MV_GIGE_ForceIpEx(IN void* handle, unsigned int nIP, unsigned int nSubNetMask, unsigned int nDefaultGateWay);
  1848. /************************************************************************/
  1849. /* GigEVision 设备独有的接口 */
  1850. /************************************************************************/
  1851. /************************************************************************
  1852. * @fn MV_GIGE_SetIpConfig
  1853. * @brief 配置IP方式
  1854. * @param handle:设备句柄
  1855. * @param nType [IN] IP类型,见MV_IP_CFG_x
  1856. * @return 见返回错误码
  1857. * @fn MV_GIGE_SetIpConfig
  1858. * @brief IP configuration method
  1859. * @param handle: Device handel
  1860. * @param nType [IN] IP type, refer to MV_IP_CFG_x
  1861. * @return Refer to error code
  1862. ************************************************************************/
  1863. MVSDKEXPORT_API int __stdcall MV_GIGE_SetIpConfig(IN void* handle, unsigned int nType);
  1864. /************************************************************************
  1865. * @fn MV_GIGE_SetNetTransMode
  1866. * @brief 设置仅使用某种模式,type: MV_NET_TRANS_x,不设置时,默认优先使用driver
  1867. * @param handle:设备句柄
  1868. * @param nType [IN] 网络传输模式,见MV_NET_TRANS_x
  1869. * @return 见返回错误码
  1870. * @fn MV_GIGE_SetNetTransMode
  1871. * @brief Set to use only one mode,type: MV_NET_TRANS_x. When do not set, priority is to use driver by default
  1872. * @param handle: Device handel
  1873. * @param nType [IN] Net transmission mode, refer to MV_NET_TRANS_x
  1874. * @return Refer to error code
  1875. ************************************************************************/
  1876. MVSDKEXPORT_API int __stdcall MV_GIGE_SetNetTransMode(IN void* handle, unsigned int nType);
  1877. /************************************************************************
  1878. * @fn MV_GIGE_GetNetTransInfo
  1879. * @brief 获取网络传输信息
  1880. * @param handle:设备句柄
  1881. * @param pstInfo [OUT] 信息结构体
  1882. * @return 见返回错误码
  1883. * @fn MV_GIGE_GetNetTransInfo
  1884. * @brief Get net transmission information
  1885. * @param handle: Device handel
  1886. * @param pstInfo [OUT] Information Structure
  1887. * @return Refer to error code
  1888. ************************************************************************/
  1889. MVSDKEXPORT_API int __stdcall MV_GIGE_GetNetTransInfo(IN void* handle, MV_NETTRANS_INFO* pstInfo);
  1890. /************************************************************************
  1891. * @fn MV_GIGE_SetGvcpTimeout
  1892. * @brief 设置GVCP命令超时时间
  1893. * @param handle [IN] 句柄地址
  1894. * @param nMillisec [IN] 超时时间,以毫秒位单位,范围:0-10000
  1895. * @return 成功,返回MV_OK;错误,返回错误码
  1896. * @fn MV_GIGE_SetGvcpTimeout
  1897. * @brief Set GVCP cammand timeout
  1898. * @param handle [IN] Handle
  1899. * @param nMillisec [IN] Timeout, ms as unit, range: 0-10000
  1900. * @return Success, return MV_OK. Failure, return error code
  1901. ************************************************************************/
  1902. MVSDKEXPORT_API int __stdcall MV_GIGE_SetGvcpTimeout(void* handle, unsigned int nMillisec);
  1903. /************************************************************************
  1904. * @fn MV_GIGE_SetResend
  1905. * @brief 设置是否打开重发包支持,及重发包设置
  1906. * @param handle [IN] 句柄地址
  1907. * @param bEnable [IN] 是否支持重发包
  1908. * @param nMaxResendPercent [IN] 最大重发比
  1909. * @param nResendTimeout [IN] 重发超时时间
  1910. * @return 成功,返回MV_OK;错误,返回错误码
  1911. * @fn MV_GIGE_SetResend
  1912. * @brief Set whethe to enable resend, and set resend
  1913. * @param handle [IN] Handle
  1914. * @param bEnable [IN] enable resend
  1915. * @param nMaxResendPercent [IN] Max resend persent
  1916. * @param nResendTimeout [IN] Resend timeout
  1917. * @return Success, return MV_OK. Failure, return error code
  1918. ************************************************************************/
  1919. MVSDKEXPORT_API int __stdcall MV_GIGE_SetResend(void* handle, unsigned int bEnable, unsigned int nMaxResendPercent, unsigned int nResendTimeout);
  1920. /************************************************************************
  1921. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_GetGevSCPSPacketSize(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1922. * @brief 获取网络包大小
  1923. * @param void* handle [IN] 相机句柄
  1924. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机网络包大小结构体指针
  1925. * @return 成功,返回MV_OK,失败,返回错误码
  1926. *
  1927. * 可参照接口MV_CC_GetWidth
  1928. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_GetGevSCPSPacketSize(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1929. * @brief Get network packet size
  1930. * @param void* handle [IN] Handle
  1931. * @param MVCC_INTVALUE* pstValue [IN][OUT] Structure pointer of network packet size
  1932. * @return Success, return MV_OK. Failure, return error code
  1933. *
  1934. * Refer to MV_CC_GetWidth
  1935. ************************************************************************/
  1936. MVSDKEXPORT_API int __stdcall MV_GIGE_GetGevSCPSPacketSize(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1937. /************************************************************************
  1938. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_SetGevSCPSPacketSize(IN void* handle, IN const unsigned int nValue);
  1939. * @brief 设置网络包大小
  1940. * @param void* handle [IN] 相机句柄
  1941. * const unsigned int nValue [IN] 想要设置的网络包大小
  1942. * @return 成功,返回MV_OK,并且相机网络包大小会更改为相应值,失败,返回错误码
  1943. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_SetGevSCPSPacketSize(IN void* handle, IN const unsigned int nValue);
  1944. * @brief Set network packet size
  1945. * @param void* handle [IN] Handle
  1946. * const unsigned int nValue [IN] Packet size to set
  1947. * @return Success, return MV_OK, and change packet size to setting value. Failure, return error code
  1948. ************************************************************************/
  1949. MVSDKEXPORT_API int __stdcall MV_GIGE_SetGevSCPSPacketSize(IN void* handle, IN const unsigned int nValue);
  1950. /************************************************************************
  1951. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_GetGevSCPD(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1952. * @brief 获取网络包发送间隔
  1953. * @param void* handle [IN] 相机句柄
  1954. * @param MVCC_INTVALUE* pstValue [IN][OUT] 返回给调用者有关相机网络包发送间隔结构体指针
  1955. * @return 成功,返回MV_OK,失败,返回错误码
  1956. *
  1957. * 可参照接口MV_CC_GetWidth
  1958. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_GetGevSCPD(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1959. * @brief Get network packet sending delay
  1960. * @param void* handle [IN] Handle
  1961. * @param MVCC_INTVALUE* pstValue [IN][OUT] Structure pointer of network packet sending delay
  1962. * @return Success, return MV_OK. Failure, return error code
  1963. *
  1964. * Refer to MV_CC_GetWidth
  1965. ************************************************************************/
  1966. MVSDKEXPORT_API int __stdcall MV_GIGE_GetGevSCPD(IN void* handle, IN OUT MVCC_INTVALUE* pstValue);
  1967. /************************************************************************
  1968. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_SetGevSCPD(IN void* handle, IN const unsigned int nValue);
  1969. * @brief 设置网络包发送间隔
  1970. * @param void* handle [IN] 相机句柄
  1971. * const unsigned int nValue [IN] 想要设置的网络包发送间隔
  1972. * @return 成功,返回MV_OK,并且相机网络包发送间隔会更改为相应值,失败,返回错误码
  1973. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_SetGevSCPD(IN void* handle, IN const unsigned int nValue);
  1974. * @brief Set network packet sending delay
  1975. * @param void* handle [IN] Handle
  1976. * const unsigned int nValue [IN] Packet delay to set
  1977. * @return Success, return MV_OK, and change packet delay to setting value. Failure, return error code
  1978. ************************************************************************/
  1979. MVSDKEXPORT_API int __stdcall MV_GIGE_SetGevSCPD(IN void* handle, IN const unsigned int nValue);
  1980. /************************************************************************
  1981. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_GetGevSCDA(IN void* handle, unsigned int* pnIP);
  1982. * @brief 获取接收端IP地址,0xa9fe0102 表示 169.254.1.2
  1983. * @param void* handle [IN] 相机句柄
  1984. * @param unsigned int* pnIP [IN][OUT] 返回给调用者接收端IP地址
  1985. * @return 成功,返回MV_OK,失败,返回错误码
  1986. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_GetGevSCDA(IN void* handle, unsigned int* pnIP);
  1987. * @brief Get receiver IP address, 0xa9fe0102 indicates 169.254.1.2
  1988. * @param void* handle [IN] Handle
  1989. * @param unsigned int* pnIP [IN][OUT] Receiver IP address
  1990. * @return Success, return MV_OK. Failure, return error code
  1991. ************************************************************************/
  1992. MVSDKEXPORT_API int __stdcall MV_GIGE_GetGevSCDA(IN void* handle, unsigned int* pnIP);
  1993. /************************************************************************
  1994. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_SetGevSCDA(IN void* handle, unsigned int nIP);
  1995. * @brief 设置接收端IP地址
  1996. * @param void* handle [IN] 相机句柄
  1997. * unsigned int nIP [IN] 想要设置的接收端IP地址
  1998. * @return 成功,返回MV_OK,并且相机接收端IP地址会更改为相应值,失败,返回错误码
  1999. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_SetGevSCDA(IN void* handle, unsigned int nIP);
  2000. * @brief Set receiver IP address
  2001. * @param void* handle [IN] Handel
  2002. * unsigned int nIP [IN] Receiver IP address to set
  2003. * @return Success, return MV_OK, and change receiver IP address to setting value. Failure, return error code
  2004. ************************************************************************/
  2005. MVSDKEXPORT_API int __stdcall MV_GIGE_SetGevSCDA(IN void* handle, unsigned int nIP);
  2006. /************************************************************************
  2007. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_GetGevSCSP(IN void* handle, unsigned int* pnPort);
  2008. * @brief 获取发送端的端口号
  2009. * @param void* handle [IN] 相机句柄
  2010. * @param unsigned int* pnPort [IN][OUT] 返回给调用者发送端的端口号
  2011. * @return 成功,返回MV_OK,失败,返回错误码
  2012. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_GetGevSCSP(IN void* handle, unsigned int* pnPort);
  2013. * @brief Get transmitter port number
  2014. * @param void* handle [IN] Handle
  2015. * @param unsigned int* pnPort [IN][OUT] Transmitter port number
  2016. * @return Success, return MV_OK. Failure, return error code
  2017. ************************************************************************/
  2018. MVSDKEXPORT_API int __stdcall MV_GIGE_GetGevSCSP(IN void* handle, unsigned int* pnPort);
  2019. /************************************************************************
  2020. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_SetGevSCSP(IN void* handle, unsigned int nPort);
  2021. * @brief 设置发送端的端口号
  2022. * @param void* handle [IN] 相机句柄
  2023. * unsigned int nPort [IN] 想要设置的发送端的端口号
  2024. * @return 成功,返回MV_OK,并且相机发送端的端口号会更改为相应值,失败,返回错误码
  2025. * @fn MVSDKEXPORT_API int __stdcall MV_GIGE_SetGevSCSP(IN void* handle, unsigned int nPort);
  2026. * @brief Set transmitter port number
  2027. * @param void* handle [IN] Handle
  2028. * unsigned int nPort [IN] Transmitter port number to set
  2029. * @return Success, return MV_OK, and change transmitter port number to setting value. Failure, return error code
  2030. ************************************************************************/
  2031. MVSDKEXPORT_API int __stdcall MV_GIGE_SetGevSCSP(IN void* handle, unsigned int nPort);
  2032. /************************************************************************
  2033. * @fn MV_GIGE_SetTransmissionType
  2034. * @brief 设置传输模式,可以为单播模式、组播模式等
  2035. * @param handle [IN] 相机句柄
  2036. * @param stTransmissionType [IN] 传输模式结构体
  2037. * @return 返回成功或错误码
  2038. ************************************************************************/
  2039. MVSDKEXPORT_API int __stdcall MV_GIGE_SetTransmissionType(void* handle, MV_TRANSMISSION_TYPE * pstTransmissionType);
  2040. /************************************************************************
  2041. * @fn MV_GIGE_IssueActionCommand
  2042. * @brief 发出动作命令
  2043. * @param pstActionCmdInfo [IN] 动作命令信息 | en:Action Command
  2044. * @param MV_ACTION_CMD_RESULT_LIST [OUT] 动作命令返回信息列表 | en:Action Command Result List
  2045. * @return 返回成功或错误码
  2046. ************************************************************************/
  2047. MVSDKEXPORT_API int __stdcall MV_GIGE_IssueActionCommand(IN MV_ACTION_CMD_INFO* pstActionCmdInfo, OUT MV_ACTION_CMD_RESULT_LIST* pstActionCmdResults);
  2048. /************************************************************************/
  2049. /* CameraLink 设备独有的接口 */
  2050. /************************************************************************/
  2051. /************************************************************************
  2052. * @fn MV_CAML_SetDeviceBauderate
  2053. * @brief 设置设备波特率
  2054. * @param handle:设备句柄
  2055. * @param nBaudrate [IN] 设置的波特率值,数值参考CameraParams.h中宏定义,如#define MV_CAML_BAUDRATE_9600 0x00000001
  2056. * @return 见返回错误码
  2057. * @fn MV_CAML_SetDeviceBauderate
  2058. * @brief Set device bauderate using one of the CL_BAUDRATE_XXXX value
  2059. * @param handle Handle
  2060. * @param nBaudrate [IN] baud rate to set. Refer to the 'CameraParams.h' for parameter definitions, for example, #define MV_CAML_BAUDRATE_9600 0x00000001
  2061. * @return Refer to error code
  2062. ************************************************************************/
  2063. MVSDKEXPORT_API int __stdcall MV_CAML_SetDeviceBauderate(IN void* handle, unsigned int nBaudrate);
  2064. /************************************************************************
  2065. * @fn MV_CAML_GetDeviceBauderate
  2066. * @brief 获取设备波特率
  2067. * @param handle:设备句柄
  2068. * @param pnCurrentBaudrate [OUT] 波特率信息指针,数值参考CameraParams.h中宏定义,如#define MV_CAML_BAUDRATE_9600 0x00000001
  2069. * @return 见返回错误码
  2070. * @fn MV_CAML_GetDeviceBauderate
  2071. * @brief Returns the current device bauderate, using one of the CL_BAUDRATE_XXXX value
  2072. * @param handle Handle
  2073. * @param pnCurrentBaudrate [OUT] Return pointer of baud rate to user. Refer to the 'CameraParams.h' for parameter definitions, for example, #define MV_CAML_BAUDRATE_9600 0x00000001
  2074. * @return Refer to error code
  2075. ************************************************************************/
  2076. MVSDKEXPORT_API int __stdcall MV_CAML_GetDeviceBauderate(IN void* handle,unsigned int* pnCurrentBaudrate);
  2077. /************************************************************************
  2078. * @fn MV_CAML_GetSupportBauderates
  2079. * @brief 获取设备与主机间连接支持的波特率
  2080. * @param handle:设备句柄
  2081. * @param pnBaudrateAblity [OUT] 支持的波特率信息的指针。所支持波特率的或运算结果,单个数值参考CameraParams.h中宏定义,如#define MV_CAML_BAUDRATE_9600 0x00000001
  2082. * @return 见返回错误码
  2083. * @fn MV_CAML_GetSupportBauderates
  2084. * @brief Returns supported bauderates of the combined device and host interface
  2085. * @param handle Handle
  2086. * @param pnBaudrateAblity [OUT] Return pointer of the supported bauderates to user. 'OR' operation results of the supported bauderates. Refer to the 'CameraParams.h' for single value definitions, for example, #define MV_CAML_BAUDRATE_9600 0x00000001
  2087. * @return Refer to error code
  2088. ************************************************************************/
  2089. MVSDKEXPORT_API int __stdcall MV_CAML_GetSupportBauderates(IN void* handle,unsigned int* pnBaudrateAblity);
  2090. /************************************************************************
  2091. * @fn MV_CAML_SetGenCPTimeOut
  2092. * @brief 设置串口操作等待时长
  2093. * @param handle:设备句柄
  2094. * @param nMillisec [IN] 串口操作的等待时长, ms
  2095. * @return 见返回错误码
  2096. * @fn MV_CAML_SetGenCPTimeOut
  2097. * @brief Sets the timeout for operations on the serial port
  2098. * @param handle Handle
  2099. * @param nMillisec [IN] Timeout in [ms] for operations on the serial port.
  2100. * @return Refer to error code
  2101. ************************************************************************/
  2102. MVSDKEXPORT_API int __stdcall MV_CAML_SetGenCPTimeOut(IN void* handle, unsigned int nMillisec);
  2103. /************************************************************************/
  2104. /* XML解析树的生成 */
  2105. /* XML parse tree generation */
  2106. /************************************************************************/
  2107. /***********************************************************************
  2108. * @fn MV_XML_GetGenICamXML
  2109. * @brief 获取相机属性树XML
  2110. * @param handle [IN] 句柄
  2111. * @param pData [OUT] 图像数据接收指针
  2112. * @param nDataSize [IN] 接收缓存大小
  2113. * @param pnDataLen [OUT] 实际数据大小
  2114. * @return 成功,返回MV_OK;错误,返回错误码
  2115. * @fn MV_XML_GetGenICamXML
  2116. * @brief Get camera feature tree XML
  2117. * @param handle [IN] Handle
  2118. * @param pData [OUT] Recevied image buffer pointer
  2119. * @param nDataSize [IN] Recevied buffer size
  2120. * @param pnDataLen [OUT] Actual data size
  2121. * @return Success, return MV_OK. Failure, return error code
  2122. ***********************************************************************/
  2123. MVSDKEXPORT_API int __stdcall MV_XML_GetGenICamXML(IN void* handle, IN OUT unsigned char* pData, IN unsigned int nDataSize, OUT unsigned int* pnDataLen);
  2124. /***********************************************************************
  2125. * @fn MV_XML_GetRootNode
  2126. * @brief 获取根节点
  2127. * @param handle [IN] 句柄
  2128. * @param pstNode [OUT] 根节点信息结构体
  2129. * @return 成功,返回MV_OK;错误,返回错误码
  2130. * @fn MV_XML_GetRootNode
  2131. * @brief Get root node
  2132. * @param handle [IN] Handle
  2133. * @param pstNode [OUT] Root node information structure
  2134. * @return Success, return MV_OK. Failure, return error code
  2135. ***********************************************************************/
  2136. MVSDKEXPORT_API int __stdcall MV_XML_GetRootNode(IN void* handle, IN OUT MV_XML_NODE_FEATURE* pstNode);
  2137. /***********************************************************************
  2138. * @fn MV_XML_GetChildren
  2139. * @brief 从xml中获取指定节点的所有子节点,根节点为Root
  2140. * @param handle [IN] 句柄
  2141. * @param pstNode [IN] 根节点信息结构体
  2142. * @param pstNodesList [OUT] 节点列表结构体
  2143. * @return 成功,返回MV_OK;错误,返回错误码
  2144. * @fn MV_XML_GetChildren
  2145. * @brief Get all children node of specific node from xml, root node is Root
  2146. * @param handle [IN] Handle
  2147. * @param pstNode [IN] Root node information structure
  2148. * @param pstNodesList [OUT] Node information structure
  2149. * @return Success, return MV_OK. Failure, return error code
  2150. ***********************************************************************/
  2151. MVSDKEXPORT_API int __stdcall MV_XML_GetChildren(IN void* handle, IN MV_XML_NODE_FEATURE* pstNode, IN OUT MV_XML_NODES_LIST* pstNodesList);
  2152. /***********************************************************************
  2153. * @fn MV_XML_GetNodeFeature
  2154. * @brief 获得当前节点的属性
  2155. * @param handle [IN] 句柄
  2156. * @param pstNode [IN] 根节点信息结构体
  2157. * @param pstFeature [OUT] 当前节点属性结构体,
  2158. pstFeature 具体结构体内容参考 MV_XML_FEATURE_x
  2159. * @return 成功,返回MV_OK;错误,返回错误码
  2160. * @fn MV_XML_GetNodeFeature
  2161. * @brief Get current node feature
  2162. * @param handle [IN] Handle
  2163. * @param pstNode [IN] Root node information structure
  2164. * @param pstFeature [OUT] Current node feature structure
  2165. Details of pstFeature refer to MV_XML_FEATURE_x
  2166. * @return Success, return MV_OK. Failure, return error code
  2167. ***********************************************************************/
  2168. MVSDKEXPORT_API int __stdcall MV_XML_GetNodeFeature(IN void* handle, IN MV_XML_NODE_FEATURE* pstNode, IN OUT void* pstFeature);
  2169. /***********************************************************************
  2170. * @fn MV_XML_UpdateNodeFeature
  2171. * @brief 更新节点
  2172. * @param handle [IN] 句柄
  2173. * @param enType [IN] 节点类型
  2174. * @param pstFeature [OUT] 当前节点属性结构体
  2175. * @return 成功,返回MV_OK;错误,返回错误码
  2176. * @fn MV_XML_UpdateNodeFeature
  2177. * @brief Update node
  2178. * @param handle [IN] Handle
  2179. * @param enType [IN] Node type
  2180. * @param pstFeature [OUT] Current node feature structure
  2181. * @return Success, return MV_OK. Failure, return error code
  2182. ***********************************************************************/
  2183. MVSDKEXPORT_API int __stdcall MV_XML_UpdateNodeFeature(IN void* handle, IN enum MV_XML_InterfaceType enType, IN void* pstFeature);
  2184. // 有节点需要更新时的回调函数
  2185. // 当调用MV_XML_UpdateNodeFeature接口更新节点属性时,注册的回调函数cbUpdate会在pstNodesList中返回与之相关联的节点
  2186. /***********************************************************************
  2187. * @fn MV_XML_RegisterUpdateCallBack
  2188. * @brief 注册更新回调
  2189. * @param handle [IN] 句柄
  2190. * @param cbUpdate [IN] 回调函数指针
  2191. * @param pUser [IN] 用户自定义变量
  2192. * @return 成功,返回MV_OK;错误,返回错误码
  2193. * @fn MV_XML_RegisterUpdateCallBack
  2194. * @brief Register update callback
  2195. * @param handle [IN] Handle
  2196. * @param cbUpdate [IN] Callback function pointer
  2197. * @param pUser [IN] User defined variable
  2198. * @return Success, return MV_OK. Failure, return error code
  2199. ***********************************************************************/
  2200. MVSDKEXPORT_API int __stdcall MV_XML_RegisterUpdateCallBack(IN void* handle,
  2201. IN void(__stdcall* cbUpdate)(enum MV_XML_InterfaceType enType, void* pstFeature, MV_XML_NODES_LIST* pstNodesList, void* pUser),
  2202. IN void* pUser);
  2203. /************************************************************************/
  2204. /* 附加接口 */
  2205. /* Additional interface */
  2206. /************************************************************************/
  2207. /************************************************************************
  2208. * @fn MV_CC_SaveImageEx2
  2209. * @brief 保存图片,支持Bmp和Jpeg.编码质量在50-99之前
  2210. * @param handle [IN] 句柄地址
  2211. * @param pSaveParam [IN][OUT] 保存图片参数结构体
  2212. pData; // [IN] 输入数据缓存
  2213. nDataLen; // [IN] 输入数据大小
  2214. enPixelType; // [IN] 输入数据的像素格式
  2215. nWidth; // [IN] 图像宽
  2216. nHeight; // [IN] 图像高
  2217. pImageBuffer; // [OUT] 输出图片缓存
  2218. nImageLen; // [OUT] 输出图片大小
  2219. nBufferSize; // [IN] 提供的输出缓冲区大小
  2220. enImageType; // [IN] 输出图片格式
  2221. nJpgQuality; // [IN] 编码质量, (50-99]
  2222. iMethodValue // [IN] Bayer格式转为RGB24的插值方法
  2223. nReserved[4];
  2224. * @return 成功,返回MV_OK;错误,返回错误码
  2225. * @fn MV_CC_SaveImageEx2
  2226. * @brief Save image, support Bmp and Jpeg. Encoding quality, (50-99]
  2227. * @param handle [IN] Handle
  2228. * @param pSaveParam [IN][OUT] Save image parameters structure
  2229. pData; // [IN] Input data buffer
  2230. nDataLen; // [IN] Input data size
  2231. enPixelType; // [IN] Pixel format of input data
  2232. nWidth; // [IN] Image width
  2233. nHeight; // [IN] Image height
  2234. pImageBuffer; // [OUT] Output image buffer
  2235. nImageLen; // [OUT] Output image size
  2236. nBufferSize; // [IN] Output buffer size provided
  2237. enImageType; // [IN] Output image format
  2238. nJpgQuality; // [IN] Encoding quality, (50-99]
  2239. iMethodValue // [IN] Interpolation method of convert Bayer to RGB24
  2240. nReserved[4];
  2241. * @return Success, return MV_OK. Failure, return error code
  2242. ************************************************************************/
  2243. MVSDKEXPORT_API int __stdcall MV_CC_SaveImageEx2(IN void* handle, IN OUT MV_SAVE_IMAGE_PARAM_EX* pSaveParam);
  2244. /************************************************************************
  2245. * @fn MV_CC_ConvertPixelType
  2246. * @brief 像素格式转换
  2247. * @param pstCvtParam [IN][OUT] 保存图片参数结构体
  2248. unsigned short nWidth; // [IN] 图像宽
  2249. unsigned short nHeight; // [IN] 图像高
  2250. enum MvGvspPixelType enSrcPixelType; // [IN] 源像素格式
  2251. unsigned char* pSrcData; // [IN] 输入数据缓存
  2252. unsigned int nSrcDataLen; // [IN] 输入数据大小
  2253. enum MvGvspPixelType enDstPixelType; // [IN] 目标像素格式
  2254. unsigned char* pDstBuffer; // [OUT] 输出数据缓存
  2255. unsigned int nDstLen; // [OUT] 输出数据大小
  2256. unsigned int nDstBufferSize; // [IN] 提供的输出缓冲区大小
  2257. * @return 成功,返回MV_OK;错误,返回错误码
  2258. * @fn MV_CC_ConvertPixelType
  2259. * @brief Pixel format conversion
  2260. * @param pstCvtParam [IN][OUT] Save image parameter structure
  2261. unsigned short nWidth; // [IN] Width
  2262. unsigned short nHeight; // [IN] Height
  2263. enum MvGvspPixelType enSrcPixelType; // [IN] Source pixel format
  2264. unsigned char* pSrcData; // [IN] Input data buffer
  2265. unsigned int nSrcDataLen; // [IN] Input data size
  2266. enum MvGvspPixelType enDstPixelType; // [IN] Destination pixel format
  2267. unsigned char* pDstBuffer; // [OUT] Output data buffer
  2268. unsigned int nDstLen; // [OUT] Output data size
  2269. unsigned int nDstBufferSize; // [IN] Provided output buffer size
  2270. * @return Success, return MV_OK. Failure, return error code
  2271. ************************************************************************/
  2272. MVSDKEXPORT_API int __stdcall MV_CC_ConvertPixelType(IN void* handle, IN OUT MV_CC_PIXEL_CONVERT_PARAM* pstCvtParam);
  2273. /************************************************************************
  2274. * @fn MV_CC_SetBayerCvtQuality
  2275. * @brief 插值算法类型设置
  2276. * @param BayerCvtQuality [IN] Bayer的插值方法 0-最近邻 1-双线性 2-Hamilton
  2277. * @return 成功,返回MV_OK;错误,返回错误码
  2278. * @fn MV_CC_SetBayerCvtQuality
  2279. * @brief Interpolation algorithm type setting
  2280. * @param BayerCvtQuality [IN] Bayer interpolation method 0-nearest neighbour 1-bilinearity 2-Hamilton
  2281. * @return Success, return MV_OK. Failure, return error code
  2282. ************************************************************************/
  2283. MVSDKEXPORT_API int __stdcall MV_CC_SetBayerCvtQuality(IN void* handle, IN unsigned int BayerCvtQuality);
  2284. /************************************************************************
  2285. * @fn MV_CC_FeatureSave
  2286. * @brief 保存相机属性
  2287. * @param handle [IN] 句柄地址
  2288. * @param pFileName [IN] 属性文件名
  2289. * @return 成功,返回MV_OK;错误,返回错误码
  2290. * @fn MV_CC_FeatureSave
  2291. * @brief Save camera feature
  2292. * @param handle [IN] Handle
  2293. * @param pFileName [IN] File name
  2294. * @return Success, return MV_OK. Failure, return error code
  2295. ************************************************************************/
  2296. MVSDKEXPORT_API int __stdcall MV_CC_FeatureSave(IN void* handle, IN const char* pFileName);
  2297. /************************************************************************
  2298. * @fn MV_CC_FeatureLoad
  2299. * @brief 导入相机属性
  2300. * @param handle [IN] 句柄地址
  2301. * @param pFileName [IN] 属性文件名
  2302. * @return 成功,返回MV_OK;错误,返回错误码
  2303. * @fn MV_CC_FeatureLoad
  2304. * @brief Load camera feature
  2305. * @param handle [IN] Handle
  2306. * @param pFileName [IN] File name
  2307. * @return Success, return MV_OK. Failure, return error code
  2308. ************************************************************************/
  2309. MVSDKEXPORT_API int __stdcall MV_CC_FeatureLoad(IN void* handle, IN const char* pFileName);
  2310. /************************************************************************
  2311. * @fn MV_CC_FileAccessRead
  2312. * @brief 从相机读取文件
  2313. * @param handle [IN] 句柄地址
  2314. * @param pstFileAccess [IN] 文件存取结构体
  2315. * @return 成功,返回MV_OK;错误,返回错误码
  2316. * @fn MV_CC_FileAccessRead
  2317. * @brief Read the file from the camera
  2318. * @param handle [IN] Handle
  2319. * @param pstFileAccess [IN] File access structure
  2320. * @return Success, return MV_OK. Failure, return error code
  2321. ************************************************************************/
  2322. MVSDKEXPORT_API int __stdcall MV_CC_FileAccessRead(IN void* handle, IN MV_CC_FILE_ACCESS * pstFileAccess);
  2323. /************************************************************************
  2324. * @fn MV_CC_FileAccessWrite
  2325. * @brief 将文件写入相机
  2326. * @param handle [IN] 句柄地址
  2327. * @param pstFileAccess [IN] 文件存取结构体
  2328. * @return 成功,返回MV_OK;错误,返回错误码
  2329. * @fn MV_CC_FileAccessWrite
  2330. * @brief Write the file to camera
  2331. * @param handle [IN] Handle
  2332. * @param pstFileAccess [IN] File access structure
  2333. * @return Success, return MV_OK. Failure, return error code
  2334. ************************************************************************/
  2335. MVSDKEXPORT_API int __stdcall MV_CC_FileAccessWrite(IN void* handle, IN MV_CC_FILE_ACCESS * pstFileAccess);
  2336. /************************************************************************
  2337. * @fn MV_CC_GetFileAccessProgress
  2338. * @brief 获取文件存取的进度
  2339. * @param handle [IN] 句柄地址
  2340. * @param pstFileAccessProgress [IN] 进度内容
  2341. * @return 成功,返回MV_OK;错误,返回错误码 (当前文件存取的状态)
  2342. * @fn MV_CC_GetFileAccessProgress
  2343. * @brief Get File Access Progress
  2344. * @param handle [IN] Handle
  2345. * @param pstFileAccessProgress [IN] File access Progress
  2346. * @return Success, return MV_OK. Failure, return error code
  2347. ************************************************************************/
  2348. MVSDKEXPORT_API int __stdcall MV_CC_GetFileAccessProgress(IN void* handle, OUT MV_CC_FILE_ACCESS_PROGRESS * pstFileAccessProgress);
  2349. /************************************************************************
  2350. * @fn MV_CC_StartRecord
  2351. * @brief 开始录像
  2352. * @param handle [IN] 句柄地址
  2353. * @param pstRecordParam [IN] 录像参数结构体
  2354. * @return 成功,返回MV_OK;错误,返回错误码
  2355. * @fn MV_CC_StartRecord
  2356. * @brief Start Record
  2357. * @param handle [IN] Handle
  2358. * @param pstRecordParam [IN] Record param structure
  2359. * @return Success, return MV_OK. Failure, return error code
  2360. ************************************************************************/
  2361. MVSDKEXPORT_API int __stdcall MV_CC_StartRecord(IN void* handle, IN MV_CC_RECORD_PARAM* pstRecordParam);
  2362. /************************************************************************
  2363. * @fn MV_CC_InputOneFrame
  2364. * @brief 输入录像数据
  2365. * @param handle [IN] 句柄地址
  2366. * @param pstInputFrameInfo [IN] 录像数据结构体
  2367. * @return 成功,返回MV_OK;错误,返回错误码
  2368. * @fn MV_CC_InputOneFrame
  2369. * @brief Input RAW data to Record
  2370. * @param handle [IN] Handle
  2371. * @param pstInputFrameInfo [IN] Record data structure
  2372. * @return Success, return MV_OK. Failure, return error code
  2373. ************************************************************************/
  2374. MVSDKEXPORT_API int __stdcall MV_CC_InputOneFrame(IN void* handle, IN MV_CC_INPUT_FRAME_INFO * pstInputFrameInfo);
  2375. /************************************************************************
  2376. * @fn MV_CC_StopRecord
  2377. * @brief 停止录像
  2378. * @param handle [IN] 句柄地址
  2379. * @return 成功,返回MV_OK;错误,返回错误码
  2380. * @fn MV_CC_StopRecord
  2381. * @brief Stop Record
  2382. * @param handle [IN] Handle
  2383. * @return Success, return MV_OK. Failure, return error code
  2384. ************************************************************************/
  2385. MVSDKEXPORT_API int __stdcall MV_CC_StopRecord(IN void* handle);
  2386. /************************************************************************/
  2387. /* 弃用的接口 */
  2388. /* Abandoned interface */
  2389. /************************************************************************/
  2390. /***********************************************************************
  2391. * @fn MV_CC_GetOneFrame
  2392. * @brief 获取一帧图像,此函数为查询式获取,每次调用查询内部缓存有
  2393. 无数据,有数据则范围数据,无数据返回错误码
  2394. (该接口已弃用,建议改用 MV_CC_GetOneFrameTimeOut接口)
  2395. * @param handle [IN] 句柄
  2396. * @param pData [OUT] 图像数据接收指针
  2397. * @param nDataSize [IN] 接收缓存大小
  2398. * @param pFrameInfo [OUT] 图像信息结构体
  2399. * @return 成功,返回MV_OK;错误,返回错误码
  2400. * @fn MV_CC_GetOneFrame
  2401. * @brief Get one frame data, this function is using query to get data,
  2402. query whether the internal cache has data, return data if there has, return error code if no data
  2403. (This interface is abandoned, it is recommended to use the MV_CC_GetOneFrameTimeOut)
  2404. * @param handle [IN] Handle
  2405. * @param pData [OUT] Recevied image data pointer
  2406. * @param nDataSize [IN] Recevied buffer size
  2407. * @param pFrameInfo [OUT] Image information structure
  2408. * @return Success, return MV_OK. Failure, return error code
  2409. ***********************************************************************/
  2410. MVSDKEXPORT_API int __stdcall MV_CC_GetOneFrame(IN void* handle, IN OUT unsigned char * pData , IN unsigned int nDataSize, IN OUT MV_FRAME_OUT_INFO* pFrameInfo);
  2411. /***********************************************************************
  2412. * @fn MV_CC_RegisterImageCallBack
  2413. * @brief 注册图像数据回调(该接口已弃用,建议改用 MV_CC_RegisterImageCallBackEx接口)
  2414. * @param handle [IN] 句柄
  2415. * @param cbOutput [IN] 回调函数指针
  2416. * @param pUser [IN] 用户自定义变量
  2417. * @return 成功,返回MV_OK;错误,返回错误码
  2418. * @fn MV_CC_RegisterImageCallBack
  2419. * @brief Register image data callback (This interface is abandoned, it is recommended to use the MV_CC_RegisterImageCallBackEx)
  2420. * @param handle [IN] Handle
  2421. * @param cbOutput [IN] Callback function pointer
  2422. * @param pUser [IN] User defined variable
  2423. * @return Success, return MV_OK. Failure, return error code
  2424. ***********************************************************************/
  2425. MVSDKEXPORT_API int __stdcall MV_CC_RegisterImageCallBack(void* handle, void(__stdcall* cbOutput)(unsigned char * pData, MV_FRAME_OUT_INFO* pFrameInfo, void* pUser),void* pUser);
  2426. /************************************************************************
  2427. * @fn MV_CC_SaveImage
  2428. * @brief 保存图片(该接口已弃用,建议改用 MV_CC_SaveImageEx接口)
  2429. * @param pSaveParam [IN][OUT] 保存图片参数结构体
  2430. pData; // [IN] 输入数据缓存
  2431. nDataLen; // [IN] 输入数据大小
  2432. enPixelType; // [IN] 输入数据的像素格式
  2433. nWidth; // [IN] 图像宽
  2434. nHeight; // [IN] 图像高
  2435. pImageBuffer; // [OUT] 输出图片缓存
  2436. nImageLen; // [OUT] 输出图片大小
  2437. nBufferSize; // [IN] 提供的输出缓冲区大小
  2438. enImageType; // [IN] 输出图片格式
  2439. * @return 成功,返回MV_OK;错误,返回错误码
  2440. * @fn MV_CC_SaveImage
  2441. * @brief Save image (This interface is abandoned, it is recommended to use the MV_CC_SaveImageEx)
  2442. * @param pSaveParam [IN][OUT] Save image parameters structure
  2443. pData; // [IN] Input data buffer
  2444. nDataLen; // [IN] Input data size
  2445. enPixelType; // [IN] Input data pixel format
  2446. nWidth; // [IN] Width
  2447. nHeight; // [IN] Height
  2448. pImageBuffer; // [OUT] Output image buffer
  2449. nImageLen; // [OUT] Output image size
  2450. nBufferSize; // [IN] Provided output buffer size
  2451. enImageType; // [IN] Output image type
  2452. * @return Success, return MV_OK. Failure, return error code
  2453. ************************************************************************/
  2454. MVSDKEXPORT_API int __stdcall MV_CC_SaveImage(IN OUT MV_SAVE_IMAGE_PARAM* pSaveParam);
  2455. /************************************************************************
  2456. * @fn MV_CC_SaveImageEx
  2457. * @brief 保存图片,支持Bmp和Jpeg.编码质量在50-99之前 (该接口已弃用,建议改用 MV_CC_SaveImageEx2接口)
  2458. * @param pSaveParam [IN][OUT] 保存图片参数结构体
  2459. pData; // [IN] 输入数据缓存
  2460. nDataLen; // [IN] 输入数据大小
  2461. enPixelType; // [IN] 输入数据的像素格式
  2462. nWidth; // [IN] 图像宽
  2463. nHeight; // [IN] 图像高
  2464. pImageBuffer; // [OUT] 输出图片缓存
  2465. nImageLen; // [OUT] 输出图片大小
  2466. nBufferSize; // [IN] 提供的输出缓冲区大小
  2467. enImageType; // [IN] 输出图片格式
  2468. nJpgQuality; // [IN] 编码质量, (50-99]
  2469. nReserved[4];
  2470. * @return 成功,返回MV_OK;错误,返回错误码
  2471. * @fn MV_CC_SaveImageEx
  2472. * @brief Save image, support Bmp and Jpeg. Encoding quality, (50-99]
  2473. * @param pSaveParam [IN][OUT] Save image parameters structure
  2474. pData; // [IN] Input data buffer
  2475. nDataLen; // [IN] Input data size
  2476. enPixelType; // [IN] Pixel format of input data
  2477. nWidth; // [IN] Image width
  2478. nHeight; // [IN] Image height
  2479. pImageBuffer; // [OUT] Output image buffer
  2480. nImageLen; // [OUT] Output image size
  2481. nBufferSize; // [IN] Output buffer size provided
  2482. enImageType; // [IN] Output image format
  2483. nJpgQuality; // [IN] Encoding quality, (50-99]
  2484. nReserved[4];
  2485. * @return Success, return MV_OK. Failure, return error code
  2486. ************************************************************************/
  2487. MVSDKEXPORT_API int __stdcall MV_CC_SaveImageEx(IN OUT MV_SAVE_IMAGE_PARAM_EX* pSaveParam);
  2488. /************************************************************************
  2489. * @fn MV_GIGE_ForceIp
  2490. * @brief 强制IP(该接口已弃用,建议改用 MV_GIGE_ForceIpEx接口)
  2491. * @param handle:设备句柄
  2492. * @param nIP [IN] 设置的IP
  2493. * @return 见返回错误码
  2494. * @fn MV_GIGE_ForceIp
  2495. * @brief Force IP (This interface is abandoned, it is recommended to use the MV_GIGE_ForceIpEx)
  2496. * @param handle Handle
  2497. * @param nIP [IN] IP to set
  2498. * @return Refer to error code
  2499. ************************************************************************/
  2500. MVSDKEXPORT_API int __stdcall MV_GIGE_ForceIp(IN void* handle, unsigned int nIP);
  2501. /************************************************************************
  2502. * @fn MV_CC_RegisterEventCallBack
  2503. * @brief 注册事件回调(该接口已弃用,建议改用 MV_CC_RegisterEventCallBackEx接口)
  2504. * @param handle:设备句柄
  2505. * @param cbEvent [IN] 事件回调函数指针
  2506. * @param pUser [IN] 用户自定义变量
  2507. * @return 见返回错误码
  2508. * @fn MV_CC_RegisterEventCallBack
  2509. * @brief Register event callback (this interface has been deprecated and is recommended to be converted to the MV_CC_RegisterEventCallBackEx interface)
  2510. * @param handle:设备句柄
  2511. * @param cbEvent [IN] event callback pointer
  2512. * @param pUser [IN] User defined value
  2513. * @return 见返回错误码
  2514. ************************************************************************/
  2515. MVSDKEXPORT_API int __stdcall MV_CC_RegisterEventCallBack(void* handle, void(__stdcall* cbEvent)(unsigned int nExternalEventId, void* pUser),void* pUser);
  2516. #ifdef __cplusplus
  2517. }
  2518. #endif
  2519. #endif