MWCapture SDK Linux  3.3.1.LAST_SVN_COMMIT_NUM
Functions
Pro Capture Family Functions

Functions

MW_RESULT LIBMWCAPTURE_API MWStartVideoCapture (HCHANNEL hChannel, MWHANDLE hEvent)
 Starts video capture. More...
 
MW_RESULT LIBMWCAPTURE_API MWStopVideoCapture (HCHANNEL hChannel)
 Stops the video capture. More...
 
MW_RESULT LIBMWCAPTURE_API MWPinVideoBuffer (HCHANNEL hChannel, MWCAP_PTR pbFrame, DWORD cbFrame)
 Locks a segment of virtual memory to reduce CPU load when capturing video data to that memory. More...
 
MW_RESULT LIBMWCAPTURE_API MWUnpinVideoBuffer (HCHANNEL hChannel, LPBYTE pbFrame)
 Unlocks a segment of virtual memory. More...
 
MW_RESULT LIBMWCAPTURE_API MWCaptureVideoFrameToVirtualAddress (HCHANNEL hChannel, int iFrame, MWCAP_PTR pbFrame, DWORD cbFrame, DWORD cbStride, BOOLEAN bBottomUp, MWCAP_PTR64 pvContext, DWORD dwFOURCC, int cx, int cy)
 Captures and saves video frames to virtual memory. More...
 
MW_RESULT LIBMWCAPTURE_API MWCaptureVideoFrameToPhysicalAddress (HCHANNEL hChannel, int iFrame, LARGE_INTEGER llFrameAddress, DWORD cbFrame, DWORD cbStride, BOOLEAN bBottomUp, MWCAP_PTR64 pvContext, DWORD dwFOURCC, int cx, int cy)
 Stores captured video frames to physical addresses. More...
 
MW_RESULT LIBMWCAPTURE_API MWCaptureVideoFrameWithOSDToVirtualAddress (HCHANNEL hChannel, int iFrame, MWCAP_PTR pbFrame, DWORD cbFrame, DWORD cbStride, BOOLEAN bBottomUp, MWCAP_PTR64 pvContext, DWORD dwFOURCC, int cx, int cy, HOSD hOSDImage, const RECT *pOSDRects, int cOSDRects)
 Captures video frames to virtual memory, and adds OSD. More...
 
MW_RESULT LIBMWCAPTURE_API MWCaptureVideoFrameWithOSDToPhysicalAddress (HCHANNEL hChannel, int iFrame, LARGE_INTEGER llFrameAddress, DWORD cbFrame, DWORD cbStride, BOOLEAN bBottomUp, MWCAP_PTR64 pvContext, DWORD dwFOURCC, int cx, int cy, HOSD hOSDImage, const RECT *pOSDRects, int cOSDRects)
 Saves the captured video frame to physical memory and adds OSD. More...
 
MW_RESULT LIBMWCAPTURE_API MWCaptureVideoFrameToVirtualAddressEx (HCHANNEL hChannel, int iFrame, LPBYTE pbFrame, DWORD cbFrame, DWORD cbStride, BOOLEAN bBottomUp, MWCAP_PTR64 pvContext, DWORD dwFOURCC, int cx, int cy, DWORD dwProcessSwitchs, int cyParitalNotify, HOSD hOSDImage, const RECT *pOSDRects, int cOSDRects, SHORT sContrast, SHORT sBrightness, SHORT sSaturation, SHORT sHue, MWCAP_VIDEO_DEINTERLACE_MODE deinterlaceMode, MWCAP_VIDEO_ASPECT_RATIO_CONVERT_MODE aspectRatioConvertMode, const RECT *pRectSrc, const RECT *pRectDest, int nAspectX, int nAspectY, MWCAP_VIDEO_COLOR_FORMAT colorFormat, MWCAP_VIDEO_QUANTIZATION_RANGE quantRange, MWCAP_VIDEO_SATURATION_RANGE satRange)
 Save captured video frames to virtual memory. It is the extended MWCaptureVideoFrameToVirtualAddress. More...
 
MW_RESULT LIBMWCAPTURE_API MWCaptureVideoFrameToPhysicalAddressEx (HCHANNEL hChannel, int iFrame, LARGE_INTEGER llFrameAddress, DWORD cbFrame, DWORD cbStride, BOOLEAN bBottomUp, MWCAP_PTR64 pvContext, DWORD dwFOURCC, int cx, int cy, DWORD dwProcessSwitchs, int cyParitalNotify, HOSD hOSDImage, const RECT *pOSDRects, int cOSDRects, SHORT sContrast, SHORT sBrightness, SHORT sSaturation, SHORT sHue, MWCAP_VIDEO_DEINTERLACE_MODE deinterlaceMode, MWCAP_VIDEO_ASPECT_RATIO_CONVERT_MODE aspectRatioConvertMode, const RECT *pRectSrc, const RECT *pRectDest, int nAspectX, int nAspectY, MWCAP_VIDEO_COLOR_FORMAT colorFormat, MWCAP_VIDEO_QUANTIZATION_RANGE quantRange, MWCAP_VIDEO_SATURATION_RANGE satRange)
 Captures video frames and saves to physical memory. And is the extended version of MWCaptureVideoFrameToPhysicalAddress. More...
 
MW_RESULT LIBMWCAPTURE_API MWGetVideoBufferInfo (HCHANNEL hChannel, MWCAP_VIDEO_BUFFER_INFO *pVideoBufferInfo)
 Gets video bufferring information. More...
 
MW_RESULT LIBMWCAPTURE_API MWGetVideoFrameInfo (HCHANNEL hChannel, BYTE i, MWCAP_VIDEO_FRAME_INFO *pVideoFrameInfo)
 Gets video frame information. More...
 
MW_RESULT LIBMWCAPTURE_API MWGetVideoCaptureStatus (HCHANNEL hChannel, MWCAP_VIDEO_CAPTURE_STATUS *pStatus)
 Gets video capture state, and frees up system storage. More...
 
HOSD LIBMWCAPTURE_API MWCreateImage (HCHANNEL hChannel, int cx, int cy)
 Creates OSD image. More...
 
MW_RESULT LIBMWCAPTURE_API MWOpenImage (HCHANNEL hChannel, HOSD hImage, LONG *plRet)
 Opens OSD images. More...
 
MW_RESULT LIBMWCAPTURE_API MWCloseImage (HCHANNEL hChannel, HOSD hImage, LONG *plRet)
 Turns off the OSD image. More...
 
MW_RESULT LIBMWCAPTURE_API MWUploadImageFromVirtualAddress (HCHANNEL hChannel, HOSD hImage, MWCAP_VIDEO_COLOR_FORMAT cfDest, MWCAP_VIDEO_QUANTIZATION_RANGE quantRangeDest, MWCAP_VIDEO_SATURATION_RANGE satRangeDest, WORD xDest, WORD yDest, WORD cxDest, WORD cyDest, MWCAP_PTR64 pvSrcFrame, DWORD cbSrcFrame, DWORD cbSrcStride, WORD cxSrc, WORD cySrc, BOOLEAN bSrcBottomUp, BOOLEAN bSrcPixelAlpha, BOOLEAN bSrcPixelXBGR)
 Uploads images from virtual memory to capture device. More...
 
MW_RESULT LIBMWCAPTURE_API MWUploadImageFromPhysicalAddress (HCHANNEL hChannel, HOSD hImage, MWCAP_VIDEO_COLOR_FORMAT cfDest, MWCAP_VIDEO_QUANTIZATION_RANGE quantRangeDest, MWCAP_VIDEO_SATURATION_RANGE satRangeDest, WORD xDest, WORD yDest, WORD cxDest, WORD cyDest, LARGE_INTEGER llSrcFrameAddress, DWORD cbSrcFrame, DWORD cbSrcStride, WORD cxSrc, WORD cySrc, BOOLEAN bSrcBottomUp, BOOLEAN bSrcPixelAlpha, BOOLEAN bSrcPixelXBGR)
 Uploads an image from physical memory to capture device. More...
 
MW_RESULT LIBMWCAPTURE_API MWGetCustomVideoTimingsCount (HCHANNEL hChannel, DWORD *dwCount)
 Gets number of custom video timings. More...
 
MW_RESULT LIBMWCAPTURE_API MWGetCustomVideoResolutionsCount (HCHANNEL hChannel, DWORD *dwCount)
 Gets number of custom video resolutions. More...
 
MW_RESULT LIBMWCAPTURE_API MWGetStreamCount (HCHANNEL hChannel, int *pnCount)
 Gets the number of streams according to channel handle. More...
 
MW_RESULT LIBMWCAPTURE_API MWGetStreamInfos (HCHANNEL hChannel, MWCAP_STREAM_INFO *pStreamInfos, int *pnCount)
 Gets the informations of streams according to channel handle. More...
 
MW_RESULT LIBMWCAPTURE_API MWSetCtrlStreamID (HCHANNEL hChannel, int nCrtlID)
 Sets the ID of controlled stream according to channel handle. More...
 
MW_RESULT LIBMWCAPTURE_API MWGetVideoCaptureOSDSettings (HCHANNEL hChannel, MWCAP_VIDEO_OSD_SETTINGS *paOSDSettings)
 Gets OSD settings. More...
 
MW_RESULT LIBMWCAPTURE_API MWSetVideoCaptureOSDSettings (HCHANNEL hChannel, MWCAP_VIDEO_OSD_SETTINGS *paOSDSettings)
 Sets OSD configurations. More...
 
MW_RESULT LIBMWCAPTURE_API MWGetVideoOSDImage (HCHANNEL hChannel, MWCAP_VIDEO_OSD_IMAGE *pOSDImage)
 Gets OSD according to channel handle. More...
 
MW_RESULT LIBMWCAPTURE_API MWSetVideoOSDImage (HCHANNEL hChannel, MWCAP_VIDEO_OSD_IMAGE OSDImage)
 Sets OSD according to channel handle. More...
 
MW_RESULT LIBMWCAPTURE_API MWGetVideoBrightness (HCHANNEL hChannel, int *pnBrightness)
 Gets the brightness of video captured according to channel handle. More...
 
MW_RESULT LIBMWCAPTURE_API MWSetVideoBrightness (HCHANNEL hChannel, int nBrightness)
 Sets the brightness of video captured according to channel handle. More...
 
MW_RESULT LIBMWCAPTURE_API MWGetVideoContrast (HCHANNEL hChannel, int *pnContrast)
 Gets the contrast of video captured according to channel handle. More...
 
MW_RESULT LIBMWCAPTURE_API MWSetVideoContrast (HCHANNEL hChannel, int nContrast)
 Sets the contrast of video captured according to channel handle. More...
 
MW_RESULT LIBMWCAPTURE_API MWGetVideoHue (HCHANNEL hChannel, int *pnHue)
 Gets the hue of video captured according to channel handle. More...
 
MW_RESULT LIBMWCAPTURE_API MWSetVideoHue (HCHANNEL hChannel, int nHue)
 Sets the hue of video captured according to channel handle. More...
 
MW_RESULT LIBMWCAPTURE_API MWGetVideoSaturation (HCHANNEL hChannel, int *pnSaturation)
 Gets the saturation of video captured according to channel handle. More...
 
MW_RESULT LIBMWCAPTURE_API MWSetVideoSaturation (HCHANNEL hChannel, int nSaturation)
 Sets the saturation of video captured according to channel handle. More...
 
MW_RESULT LIBMWCAPTURE_API MWSaveSettingsAsPreset (HCHANNEL hChannel)
 Saves the presetting configurations of video capture according to channel handle. More...
 
MW_RESULT LIBMWCAPTURE_API MWReloadPreset (HCHANNEL hChannel)
 Reloads the presetting configurations of video capture according to channel handle. More...
 
MWCAP_PTR LIBMWCAPTURE_API MWCreateEvent ()
 Creates events. More...
 
MW_RESULT LIBMWCAPTURE_API MWCloseEvent (MWCAP_PTR hEvent)
 Destroys the event. More...
 
MW_RESULT LIBMWCAPTURE_API MWSetEvent (MWCAP_PTR hEvent)
 Triggers the event. More...
 
MW_RESULT LIBMWCAPTURE_API MWClearEvent (MWCAP_PTR hEvent)
 Resets the event. More...
 
BOOLEAN LIBMWCAPTURE_API MWIsSetEvent (MWCAP_PTR hEvent)
 Querys whether the event is triggered. More...
 
int LIBMWCAPTURE_API MWTryWaitEvent (MWCAP_PTR hEvent)
 Waits for the event. More...
 
int LIBMWCAPTURE_API MWWaitEvent (MWCAP_PTR hEvent, int nTimeout)
 Waits for the event. More...
 
DWORD LIBMWCAPTURE_API MWMultiWaitEvent (MWCAP_PTR *hEvents, int nCount, int nTimeout)
 Waits for the events. More...
 

Detailed Description

Function Documentation

MW_RESULT LIBMWCAPTURE_API MWCaptureVideoFrameToPhysicalAddress ( HCHANNEL  hChannel,
int  iFrame,
LARGE_INTEGER  llFrameAddress,
DWORD  cbFrame,
DWORD  cbStride,
BOOLEAN  bBottomUp,
MWCAP_PTR64  pvContext,
DWORD  dwFOURCC,
int  cx,
int  cy 
)

Stores captured video frames to physical addresses.

Parameters
[in]hChannelchannel handle that has started video capturing
[in]iFrameVideo frame number to be captured
[in]llFrameAddressPhysical addresses that store the captured video frames
[in]cbFrameByte length of memory that stores the captured data
[in]cbStrideStep of memory that stores the captured data
[in]bBottomUpWhether to store the captured video frames from bottom to top
[in]pvContextCustom context pointer
[in]dwFOURCCColor format of captured video frames, see MWFOURCC.h.
[in]cxWidth of captured video frames
[in]cyHeight of captured video frames
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).
Note

Be cautious when using it.
MW_RESULT LIBMWCAPTURE_API MWCaptureVideoFrameToPhysicalAddressEx ( HCHANNEL  hChannel,
int  iFrame,
LARGE_INTEGER  llFrameAddress,
DWORD  cbFrame,
DWORD  cbStride,
BOOLEAN  bBottomUp,
MWCAP_PTR64  pvContext,
DWORD  dwFOURCC,
int  cx,
int  cy,
DWORD  dwProcessSwitchs,
int  cyParitalNotify,
HOSD  hOSDImage,
const RECT pOSDRects,
int  cOSDRects,
SHORT  sContrast,
SHORT  sBrightness,
SHORT  sSaturation,
SHORT  sHue,
MWCAP_VIDEO_DEINTERLACE_MODE  deinterlaceMode,
MWCAP_VIDEO_ASPECT_RATIO_CONVERT_MODE  aspectRatioConvertMode,
const RECT pRectSrc,
const RECT pRectDest,
int  nAspectX,
int  nAspectY,
MWCAP_VIDEO_COLOR_FORMAT  colorFormat,
MWCAP_VIDEO_QUANTIZATION_RANGE  quantRange,
MWCAP_VIDEO_SATURATION_RANGE  satRange 
)

Captures video frames and saves to physical memory. And is the extended version of MWCaptureVideoFrameToPhysicalAddress.

Parameters
[in]hChannelchannel handle that has started video capturing
[in]iFrameVideo frame number to be captured
[in]llFrameAddressPhysical addresses that store the captured video frames
[in]cbFrameByte length of memory that stores the captured data
[in]cbStrideStep of memory that stores the captured data
[in]bBottomUpWhether to store the captured video frames from bottom to top
[in]pvContextCustom context pointer
[in]dwFOURCCColor format of captured video frames, see MWFOURCC.h.
[in]cxwidth of captured video frames
[in]cyHeight of captured video frames
[in]dwProcessSwitchsMask of video processing refers to MWCAP_VIDEO_PROCESS_xx
[in]cyParitalNotifyThe number of lines when capturing by lines
[in]hOSDImageOSD image handle which is got by using MWCreateImage(HCHANNEL hChannel,int cx,int cy)
[in]pOSDRectsTarget areas of OSD image
[in]cOSDRectsNumber of OSD image target areas
[in]sContrastContrast
[in]sBrightnessBrightness
[in]sSaturationSaturation
[in]sHueHue
[in]deinterlaceModeDeinterlace Mode
[in]aspectRatioConvertModeAspect Ratio Convert Mode
[in]pRectSrcThe source area of the image to capture
[in]pRectDestThe destination area of the image to capture
[in]nAspectXWidth of the aspect ratio
[in]nAspectYHeight of the aspect ratio
[in]colorFormatColor Format
[in]quantRangeQuantization Range
[in]satRangeSaturation Range
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Be cautious when using it.

MW_RESULT LIBMWCAPTURE_API MWCaptureVideoFrameToVirtualAddress ( HCHANNEL  hChannel,
int  iFrame,
MWCAP_PTR  pbFrame,
DWORD  cbFrame,
DWORD  cbStride,
BOOLEAN  bBottomUp,
MWCAP_PTR64  pvContext,
DWORD  dwFOURCC,
int  cx,
int  cy 
)

Captures and saves video frames to virtual memory.

Parameters
[in]hChannelchannel handle that has started video capturing
[in]iFrameVideo frame number to be captured
[out]pbFrameStores virtual memory pointers for captured data
[in]cbFrameByte length of memory that stores the captured data
[in]cbStrideStep of memory that stores the captured data
[in]bBottomUpWhether to store the captured video frames from bottom to top
[in]pvContextCustom context pointer
[in]dwFOURCCColor format of captured video frames, see MWFOURCC.h.
[in]cxWidth of captured video frames
[in]cyHeight of captured video frames
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Related function(s): MWRegisterNotify
MWRegisterTimer

MW_RESULT LIBMWCAPTURE_API MWCaptureVideoFrameToVirtualAddressEx ( HCHANNEL  hChannel,
int  iFrame,
LPBYTE  pbFrame,
DWORD  cbFrame,
DWORD  cbStride,
BOOLEAN  bBottomUp,
MWCAP_PTR64  pvContext,
DWORD  dwFOURCC,
int  cx,
int  cy,
DWORD  dwProcessSwitchs,
int  cyParitalNotify,
HOSD  hOSDImage,
const RECT pOSDRects,
int  cOSDRects,
SHORT  sContrast,
SHORT  sBrightness,
SHORT  sSaturation,
SHORT  sHue,
MWCAP_VIDEO_DEINTERLACE_MODE  deinterlaceMode,
MWCAP_VIDEO_ASPECT_RATIO_CONVERT_MODE  aspectRatioConvertMode,
const RECT pRectSrc,
const RECT pRectDest,
int  nAspectX,
int  nAspectY,
MWCAP_VIDEO_COLOR_FORMAT  colorFormat,
MWCAP_VIDEO_QUANTIZATION_RANGE  quantRange,
MWCAP_VIDEO_SATURATION_RANGE  satRange 
)

Save captured video frames to virtual memory. It is the extended MWCaptureVideoFrameToVirtualAddress.

Parameters
[in]hChannelchannel handle that has started video capturing
[in]iFrameVideo frame number to be captured
[out]pbFrameVirtual addresses that store the captured video frames
[in]cbFrameByte length of memory that stores the captured data
[in]cbStrideStep of memory that stores the captured data
[in]bBottomUpWhether to store the captured video frames from bottom to top
[in]pvContextCustom context pointer
[in]dwFOURCCColor format of captured video frames, see MWFOURCC.h.
[in]cxwidth of captured video frames
[in]cyHeight of captured video frames
[in]dwProcessSwitchsImage processing mask. Refers to MWCAP_VIDEO_PROCESS_xx
[in]cyParitalNotifyNumber of rows captured by lines
[in]hOSDImageOSD image handle which is got by using MWCreateImage.
[in]pOSDRectsTarget areas of OSD image
[in]cOSDRectsNumber of OSD image target areas
[in]sContrastContrast
[in]sBrightnessBrightness
[in]sSaturationSaturation
[in]sHueHue
[in]deinterlaceModeDeinterlace Mode
[in]aspectRatioConvertModeAspect Ratio Convert Mode
[in]pRectSrcThe source area of the image to capture
[in]pRectDestThe destination area of the image to capture
[in]nAspectXWidth of the aspect ratio
[in]nAspectYHeight of the aspect ratio
[in]colorFormatColor Format
[in]quantRangeQuantization Range
[in]satRangeSaturation Range
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Captures video frames and saves the data to virtual memory. The extended version of MWCaptureVideoFrameToVirtualAddress but has more parameters for controlling.

1 char path[128];
2 MWGetDevicePath(k,path);
3 HCHANNEL t_channel=MWOpenChannelByPath(path);
4 ...
5 MW_RESULT xr;
6 HOSD hOSD = MWCreateImage(t_channel, CAPTURE_WIDTH, CAPTURE_HEIGHT);
7 ...
8 xr = MWStartVideoCapture(t_channel, hCaptureEvent);
9 ...
10 HNOTIFY hNotify = MWRegisterNotify(t_channel, hNotifyEvent, MWCAP_NOTIFY_VIDEO_FRAME_BUFFERED);
11 ...
12 MWWaitEvent(hNotifyEvent, INFINITE);
13 xr = MWGetNotifyStatus(t_channel, hNotify, &ullStatusBits);
14 MWCAP_VIDEO_BUFFER_INFO videoBufferInfo;
15 xr = MWGetVideoBufferInfo(t_channel, &videoBufferInfo);
16 MWCAP_VIDEO_FRAME_INFO videoFrameInfo;
17 xr = MWGetVideoFrameInfo(t_channel, videoBufferInfo.iNewestBufferedFullFrame, &videoFrameInfo);
18 xr =MWCaptureVideoFrameToVirtualAddressEx(t_channel,
19  MWCAP_VIDEO_FRAME_ID_NEWEST_BUFFERED,
20  m_p_buffer,m_cb_buffer,t_n_stride,FALSE,NULL,m_dw_fourcc,t_n_width,t_n_height,
21  0,0,NULL,NULL,0,100,0,100,0,MWCAP_VIDEO_DEINTERLACE_BLEND,
22  MWCAP_VIDEO_ASPECT_RATIO_IGNORE,NULL,NULL,
23  0,0,MWCAP_VIDEO_COLOR_FORMAT_UNKNOWN,
24  MWCAP_VIDEO_QUANTIZATION_UNKNOWN,
25  MWCAP_VIDEO_SATURATION_UNKNOWN);
26 MWCAP_VIDEO_CAPTURE_STATUS captureStatus;
27 xr = MWGetVideoCaptureStatus(t_channel, &captureStatus);
28 ...
29 xr = MWUnregisterNotify(t_channel, hNotify);
30 xr = MWStopVideoCapture(t_channel);
31 ...
32 MWCloseChannel(t_channel);
MW_RESULT LIBMWCAPTURE_API MWCaptureVideoFrameWithOSDToPhysicalAddress ( HCHANNEL  hChannel,
int  iFrame,
LARGE_INTEGER  llFrameAddress,
DWORD  cbFrame,
DWORD  cbStride,
BOOLEAN  bBottomUp,
MWCAP_PTR64  pvContext,
DWORD  dwFOURCC,
int  cx,
int  cy,
HOSD  hOSDImage,
const RECT pOSDRects,
int  cOSDRects 
)

Saves the captured video frame to physical memory and adds OSD.

Parameters
[in]hChannelchannel handle that has started video capturing
[in]iFrameVideo frame number to be captured
[in]llFrameAddressPhysical addresses that store the captured video frames
[in]cbFrameByte length of memory that stores the captured data
[in]cbStrideStep of memory that stores the captured data
[in]bBottomUpWhether to store the captured video frames from bottom to top
[in]pvContextCustom context pointer
[in]dwFOURCCColor format of captured video frames, see MWFOURCC.h.
[in]cxwidth of captured video frames
[in]cyHeight of captured video frames
[in]hOSDImagehandle of OSD image which is got by using MWCreateImage.
[in]pOSDRectsTarget areas of OSD image
[in]cOSDRectsNumber of OSD image target areas
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Be cautious when using it.

MW_RESULT LIBMWCAPTURE_API MWCaptureVideoFrameWithOSDToVirtualAddress ( HCHANNEL  hChannel,
int  iFrame,
MWCAP_PTR  pbFrame,
DWORD  cbFrame,
DWORD  cbStride,
BOOLEAN  bBottomUp,
MWCAP_PTR64  pvContext,
DWORD  dwFOURCC,
int  cx,
int  cy,
HOSD  hOSDImage,
const RECT pOSDRects,
int  cOSDRects 
)

Captures video frames to virtual memory, and adds OSD.

Parameters
[in]hChannelchannel handle that has started video capturing
[in]iFrameVideo frame number to be captured
[out]pbFramevirtual addresses that store the captured video frames
[in]cbFrameByte length of memory that stores the captured data
[in]cbStrideStep of memory that stores the captured data
[in]bBottomUpWhether to store the captured video frames from bottom to top
[in]pvContextCustom context pointer
[in]dwFOURCCColor format of captured video frames, see MWFOURCC.h.
[in]cxWidth of captured video frames
[in]cyHeight of captured video frames
[in]hOSDImageHandle of OSD image which is got by using MWCreateImage
[in]pOSDRectsTarget areas of OSD image
[in]cOSDRectsNumber of OSD image target areas
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Saves the captured video frame to virtual memory, and adds OSD.

1 MWHANDLE path[128];
2 MWGetDevicePath(k,path);
3 HCHANNEL t_channel=MWOpenChannelByPath(path);
4 ...
5 MW_RESULT xr;
6 HOSD hOSD = MWCreateImage(t_channel, CAPTURE_WIDTH, CAPTURE_HEIGHT);
7 ...
8 xr = MWStartVideoCapture(t_channel, hCaptureEvent);
9 ...
10 HNOTIFY hNotify = MWRegisterNotify(t_channel, hNotifyEvent, MWCAP_NOTIFY_VIDEO_FRAME_BUFFERED);
11 ...
12 MWWaitEvent(hNotifyEvent, INFINITE);
13 xr = MWGetNotifyStatus(t_channel, hNotify, &ullStatusBits);
14 MWCAP_VIDEO_BUFFER_INFO videoBufferInfo;
15 xr = MWGetVideoBufferInfo(t_channel, &videoBufferInfo);
16 MWCAP_VIDEO_FRAME_INFO videoFrameInfo;
17 xr = MWGetVideoFrameInfo(t_channel, videoBufferInfo.iNewestBufferedFullFrame, &videoFrameInfo);
18 xr=MWCaptureVideoFrameWithOSDToVirtualAddress(t_channel, MWCAP_VIDEO_FRAME_ID_NEWEST_BUFFERED, byBuffer, dwFrameSize, cbStride, FALSE, NULL, CAPTURE_COLOR, CAPTURE_WIDTH, CAPTURE_HEIGHT, hOSD, aOSDRects, 1);
19 MWWaitEvent(hCaptureEvent, INFINITE);
20 MWCAP_VIDEO_CAPTURE_STATUS captureStatus;
21 xr = MWGetVideoCaptureStatus(t_channel, &captureStatus);
22 ...
23 xr = MWUnregisterNotify(t_channel, hNotify);
24 xr = MWStopVideoCapture(t_channel);
25 ...
26 MWCloseImage(t_channel, hOSD, &lRet);
27 ...
28 MWCloseChannel(t_channel);
MW_RESULT LIBMWCAPTURE_API MWClearEvent ( MWCAP_PTR  hEvent)

Resets the event.

Parameters
[in]hEventEvent
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWCloseEvent ( MWCAP_PTR  hEvent)

Destroys the event.

Parameters
[in]hEventEvent handle
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWCloseImage ( HCHANNEL  hChannel,
HOSD  hImage,
LONG *  plRet 
)

Turns off the OSD image.

Parameters
[in]hChannelOpened channel handle
[in]hImageImage handle
[out]plRetReturns counts of the image being called
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Turns off the OSD image and frees the OSD occupied resources.
Related function(s): MWOpenImage
Using MWCreateImage needs to call MWCloseImage.
Using MWOpenImage needs to call MWCloseImage.

MWCAP_PTR LIBMWCAPTURE_API MWCreateEvent ( )

Creates events.

Returns
Returns event handle if succeeded, otherwise return 0
HOSD LIBMWCAPTURE_API MWCreateImage ( HCHANNEL  hChannel,
int  cx,
int  cy 
)

Creates OSD image.

Parameters
[in]hChannelOpened channel handle
[in]cxWidth of image
[in]cyHeight of image
Returns
Returns image handle if succeeded, otherwise returns NULL.

Usage:
Creates OSD image.
Related function(s): MWCaptureVideoFrameWithOSDToVirtualAddress

MW_RESULT LIBMWCAPTURE_API MWGetCustomVideoResolutionsCount ( HCHANNEL  hChannel,
DWORD *  dwCount 
)

Gets number of custom video resolutions.

Parameters
[in]hChannelOpened channel handle
[out]dwCountNumber of custom video resolutions
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:

1 char pDevicePath[128] = {0};
2 mr = MWGetDevicePath(i, pDevicePath);
3 ...
4 HCHANNEL hChannel = MWOpenChannelByPath(pDevicePath);
5 ...
6 DWORD t_dw_count;
7 MWGetCustomVideoResolutionsCount(hChannel, &t_dw_count);
8 ...
9 MWCloseChannel(hChannel);
MW_RESULT LIBMWCAPTURE_API MWGetCustomVideoTimingsCount ( HCHANNEL  hChannel,
DWORD *  dwCount 
)

Gets number of custom video timings.

Parameters
[in]hChannelOpened channel handle
[out]dwCountNumber of custom video timings
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:

1 char pDevicePath[128] = {0};
2 mr = MWGetDevicePath(i, pDevicePath);
3 ...
4 HCHANNEL hChannel = MWOpenChannelByPath(pDevicePath);
5 ...
6 DWORD t_dw_count;
7 MWGetCustomVideoTimingsCount(hChannel, &t_dw_count);
8 ...
9 MWCloseChannel(hChannel);
MW_RESULT LIBMWCAPTURE_API MWGetStreamCount ( HCHANNEL  hChannel,
int *  pnCount 
)

Gets the number of streams according to channel handle.

Parameters
[in]hChannelchannel handle
[in]pnCountthe number of streams
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWGetStreamInfos ( HCHANNEL  hChannel,
MWCAP_STREAM_INFO pStreamInfos,
int *  pnCount 
)

Gets the informations of streams according to channel handle.

Parameters
[in]hChannelchannel handle
[in]pStreamInfosinformation of streams
[in]pnCountthe number of streams
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWGetVideoBrightness ( HCHANNEL  hChannel,
int *  pnBrightness 
)

Gets the brightness of video captured according to channel handle.

Parameters
[in]hChannelChannel handle
[out]pnBrightnessBrightness of video captured
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWGetVideoBufferInfo ( HCHANNEL  hChannel,
MWCAP_VIDEO_BUFFER_INFO pVideoBufferInfo 
)

Gets video bufferring information.

Parameters
[in]hChannelchannel handle that has started video capturing
[out]pVideoBufferInfoVideo bufferring information
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Gets video buffer on-board storage information that gives you the current number of video buffer frames and the frame id being cached.
Related function(s): MWRegisterNotify
MWRegisterTimer

MW_RESULT LIBMWCAPTURE_API MWGetVideoCaptureOSDSettings ( HCHANNEL  hChannel,
MWCAP_VIDEO_OSD_SETTINGS paOSDSettings 
)

Gets OSD settings.

Parameters
[in]hChannelOpened channel handle
[out]paOSDSettingsOSD settings
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Only png and rgba images are supported.

1 char pDevicePath[128] = {0};
2 mr = MWGetDevicePath(i, pDevicePath);
3 ...
4 HCHANNEL hChannel = MWOpenChannelByPath(pDevicePath);
5 ...
6 MWCAP_VIDEO_OSD_SETTINGS t_osd_setting;
7  MWGetVideoCaptureOSDSettings(hChannel, &t_osd_setting);
8 ...
9 MWCloseChannel(hChannel);
MW_RESULT LIBMWCAPTURE_API MWGetVideoCaptureStatus ( HCHANNEL  hChannel,
MWCAP_VIDEO_CAPTURE_STATUS pStatus 
)

Gets video capture state, and frees up system storage.

Parameters
[in]hChannelchannel handle that has started video capturing
[out]pStatusReturns video capture state
Returns
Function return values are as follows:
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Gets video capture state. After the capture function call is completed, call the function, which gets the capture state while cleaning up the occupied system storage.
Related function(s): MWRegisterNotify
MWRegisterTimer

MW_RESULT LIBMWCAPTURE_API MWGetVideoContrast ( HCHANNEL  hChannel,
int *  pnContrast 
)

Gets the contrast of video captured according to channel handle.

Parameters
[in]hChannelChannel handle
[out]pnContrastContrast of video captured
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWGetVideoFrameInfo ( HCHANNEL  hChannel,
BYTE  i,
MWCAP_VIDEO_FRAME_INFO pVideoFrameInfo 
)

Gets video frame information.

Parameters
[in]hChannelVideo channel handle that has started video capturing
[in]iVideo frame index
[out]pVideoFrameInfoReturns video frame information
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Gets video frame information, including bufferring start and end time with time code.
Related function(s): MWRegisterNotify
MWRegisterTimer

MW_RESULT LIBMWCAPTURE_API MWGetVideoHue ( HCHANNEL  hChannel,
int *  pnHue 
)

Gets the hue of video captured according to channel handle.

Parameters
[in]hChannelChannel handle
[in]pnHueHue of video captured
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWGetVideoOSDImage ( HCHANNEL  hChannel,
MWCAP_VIDEO_OSD_IMAGE pOSDImage 
)

Gets OSD according to channel handle.

Parameters
[in]hChannelChannel handle
[out]pOSDImageOSD image
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWGetVideoSaturation ( HCHANNEL  hChannel,
int *  pnSaturation 
)

Gets the saturation of video captured according to channel handle.

Parameters
[in]hChannelChannel handle
[out]pnSaturationSaturation of video captured
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
BOOLEAN LIBMWCAPTURE_API MWIsSetEvent ( MWCAP_PTR  hEvent)

Querys whether the event is triggered.

Parameters
[in]hEventEvent
Returns
Returns TRUE if succeeded, otherwise returns FALSE
DWORD LIBMWCAPTURE_API MWMultiWaitEvent ( MWCAP_PTR *  hEvents,
int  nCount,
int  nTimeout 
)

Waits for the events.

Parameters
[in]hEventsEvents
[in]nCountThe number of event objects
[in]nTimeoutTimeout period
Returns
Returns event flag if succeeded
MW_RESULT LIBMWCAPTURE_API MWOpenImage ( HCHANNEL  hChannel,
HOSD  hImage,
LONG *  plRet 
)

Opens OSD images.

Parameters
[in]hChannelOpened channel handle
[in]hImageImage handle
[out]plRetReturns counts of the image being called
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Opens OSD image, and loads it to specified channel.

1 char pDevicePath[128] = {0};
2 mr = MWGetDevicePath(i, pDevicePath);
3 ...
4 HCHANNEL hChannel = MWOpenChannelByPath(pDevicePath);
5 ...
6 HOSD hOSD = NULL;
7 hOSD =MWCreateImage(hChannel, 1920, 1080);
8 ...
9 HCHANNEL hChannel1 = MWOpenChannelByPath(pDevicePath);
10 ...
11 LONG lRet = 0;
12 mr = MWOpenImage(hChannel1, hOSD, &lRet);
13 ...
14 mr = MWCloseImage(hChannel1, hOSD, &lRet);
15 mr = MWCloseImage(hChannel, hOSD, &lRet);
16 ...
17 MWCloseChannel(hChannel1);
18 MWCloseChannel(hChannel);
MW_RESULT LIBMWCAPTURE_API MWPinVideoBuffer ( HCHANNEL  hChannel,
MWCAP_PTR  pbFrame,
DWORD  cbFrame 
)

Locks a segment of virtual memory to reduce CPU load when capturing video data to that memory.

Parameters
[in]hChannelOpened channel handle
[in]pbFrameVirtual memory address
[in]cbFrameVirtual memory size
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Locks a segment of virtual memory to reduce the CPU usage when storing the captured video clips to that memory.

1 char path[128];
2 MWGetDevicePath(k,path);
3 HCHANNEL t_channel=MWOpenChannelByPath(path);
4 ...
5 MW_RESULT xr;
6 xr = MWPinVideoBuffer(t_channel, byBuffer, dwFrameSize)
7 ...
8 xr = MWStartVideoCapture(t_channel, hCaptureEvent);
9 ...
10 ...
11 xr = MWStopVideoCapture(t_channel);
12 xr = MWUnpinVideoBuffer(t_channel, byBuffer);
13 ...
14 MWCloseChannel(t_channel);
MW_RESULT LIBMWCAPTURE_API MWReloadPreset ( HCHANNEL  hChannel)

Reloads the presetting configurations of video capture according to channel handle.

Parameters
[in]hChannelChannel handle
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWSaveSettingsAsPreset ( HCHANNEL  hChannel)

Saves the presetting configurations of video capture according to channel handle.

Parameters
[in]hChannelChannel handle
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWSetCtrlStreamID ( HCHANNEL  hChannel,
int  nCrtlID 
)

Sets the ID of controlled stream according to channel handle.

Parameters
[in]hChannelchannel handle
[in]nCrtlIDID of controlled stream
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWSetEvent ( MWCAP_PTR  hEvent)

Triggers the event.

Parameters
[in]hEventEvent
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWSetVideoBrightness ( HCHANNEL  hChannel,
int  nBrightness 
)

Sets the brightness of video captured according to channel handle.

Parameters
[in]hChannelChannel handle
[in]nBrightnessBrightness of video captured
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWSetVideoCaptureOSDSettings ( HCHANNEL  hChannel,
MWCAP_VIDEO_OSD_SETTINGS paOSDSettings 
)

Sets OSD configurations.

Parameters
[in]hChannelOpened channel handle
[out]paOSDSettingsOSD configurations
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:

1 char pDevicePath[128] = {0};
2 mr = MWGetDevicePath(i, pDevicePath);
3 ...
4 HCHANNEL hChannel = MWOpenChannelByPath(pDevicePath);
5 ...
6 MWCAP_VIDEO_OSD_SETTINGS t_osd_setting;
7 t_osd_setting.xx=...;
8 ...
9 MWSetVideoCaptureOSDSettings(hChannel, &t_osd_setting);
10 ...
11 MWCloseChannel(hChannel);
MW_RESULT LIBMWCAPTURE_API MWSetVideoContrast ( HCHANNEL  hChannel,
int  nContrast 
)

Sets the contrast of video captured according to channel handle.

Parameters
[in]hChannelChannel handle
[in]nContrastContrast of video captured
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWSetVideoHue ( HCHANNEL  hChannel,
int  nHue 
)

Sets the hue of video captured according to channel handle.

Parameters
[in]hChannelChannel handle
[in]nHueHue of video captured
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWSetVideoOSDImage ( HCHANNEL  hChannel,
MWCAP_VIDEO_OSD_IMAGE  OSDImage 
)

Sets OSD according to channel handle.

Parameters
[in]hChannelChannel handle
[in]OSGImageOSD image
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWSetVideoSaturation ( HCHANNEL  hChannel,
int  nSaturation 
)

Sets the saturation of video captured according to channel handle.

Parameters
[in]hChannelChannel handle
[in]nSaturationSaturation of video captured
Returns
Returns MW_SUCCEED if succeeded, otherwise returns MW_FAILED or MW_INVALID_PARAMS
MW_RESULT LIBMWCAPTURE_API MWStartVideoCapture ( HCHANNEL  hChannel,
MWHANDLE  hEvent 
)

Starts video capture.

Parameters
[in]hChannelOpened channel handle
[in]hEventAn event handle
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
It is used for Pro capture cards.
Related function(s): MWRegisterNotify
MWRegisterTimer

MW_RESULT LIBMWCAPTURE_API MWStopVideoCapture ( HCHANNEL  hChannel)

Stops the video capture.

Parameters
[in]hChannelOpened channel handle
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Related function(s): MWRegisterNotify
MWRegisterTimer

int LIBMWCAPTURE_API MWTryWaitEvent ( MWCAP_PTR  hEvent)

Waits for the event.

Parameters
[in]hEventEvent
Returns
Returns 1 if succeeded
MW_RESULT LIBMWCAPTURE_API MWUnpinVideoBuffer ( HCHANNEL  hChannel,
LPBYTE  pbFrame 
)

Unlocks a segment of virtual memory.

Parameters
[in]hChannelOpened channel handle
[in]pbFrameVirtual memory address
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Unlocks a segment of virtual memory, and works with MWPinVideoBuffer.
Related function(s): MWPinVideoBuffer

MW_RESULT LIBMWCAPTURE_API MWUploadImageFromPhysicalAddress ( HCHANNEL  hChannel,
HOSD  hImage,
MWCAP_VIDEO_COLOR_FORMAT  cfDest,
MWCAP_VIDEO_QUANTIZATION_RANGE  quantRangeDest,
MWCAP_VIDEO_SATURATION_RANGE  satRangeDest,
WORD  xDest,
WORD  yDest,
WORD  cxDest,
WORD  cyDest,
LARGE_INTEGER  llSrcFrameAddress,
DWORD  cbSrcFrame,
DWORD  cbSrcStride,
WORD  cxSrc,
WORD  cySrc,
BOOLEAN  bSrcBottomUp,
BOOLEAN  bSrcPixelAlpha,
BOOLEAN  bSrcPixelXBGR 
)

Uploads an image from physical memory to capture device.

Parameters
[in]hChannelOpened channel handle
[in]hImageImage handle
[in]cfDestColor format of the target image
[in]quantRangeDestQuantization range of the target image
[in]satRangeDestSaturation range of the target image
[in]xDestHorizontal target position
[in]yDestVertical target position
[in]cxDestTarget width of image
[in]cyDestTarget height of image
[in]llSrcFrameAddressPhysical address that stores the source image
[in]cbSrcFrameData length of source image
[in]cbSrcStrideData step of source image
[in]cxSrcWidth of source image
[in]cySrcHeight of source image
[in]bSrcBottomUpWhether the source image is up-side-down
[in]bSrcPixelAlphaWhether there is an alpha component in the source image
[in]bSrcPixelXBGRWhether the color format of the source image is XBGR
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Uploads an image from physical memory to capture device.
Be cautious when using it.

MW_RESULT LIBMWCAPTURE_API MWUploadImageFromVirtualAddress ( HCHANNEL  hChannel,
HOSD  hImage,
MWCAP_VIDEO_COLOR_FORMAT  cfDest,
MWCAP_VIDEO_QUANTIZATION_RANGE  quantRangeDest,
MWCAP_VIDEO_SATURATION_RANGE  satRangeDest,
WORD  xDest,
WORD  yDest,
WORD  cxDest,
WORD  cyDest,
MWCAP_PTR64  pvSrcFrame,
DWORD  cbSrcFrame,
DWORD  cbSrcStride,
WORD  cxSrc,
WORD  cySrc,
BOOLEAN  bSrcBottomUp,
BOOLEAN  bSrcPixelAlpha,
BOOLEAN  bSrcPixelXBGR 
)

Uploads images from virtual memory to capture device.

Parameters
[in]hChannelOpened channel handle
[in]hImageImage handle
[in]cfDestColor format of the target image
[in]quantRangeDestQuantization range of the target image
[in]satRangeDestSaturation range of the target image
[in]xDestHorizontal target position
[in]yDestVertical target position
[in]cxDestTarget width of image
[in]cyDestTarget height of image
[in]pvSrcFrameSource image
[in]cbSrcFrameData length of source image
[in]cbSrcStrideData step of source image
[in]cxSrcWidth of source image
[in]cySrcHeight of source image
[in]bSrcBottomUpWhether the source image is up-side-down
[in]bSrcPixelAlphaWhether there is an alpha component in the source image
[in]bSrcPixelXBGRWhether the color format of the source image is XBGR
Returns
Function return values are as follows
MW_SUCCEEDED Function call succeeded.
MW_FAILED Function call failed.
MW_INVALID_PARAMS Input invalid value(s).

Usage:
Uploads images from system memory to capture device.

int LIBMWCAPTURE_API MWWaitEvent ( MWCAP_PTR  hEvent,
int  nTimeout 
)

Waits for the event.

Parameters
[in]hEventEvent
[in]nTimeoutTimeout period
Returns
Returns 1 if succeeded