Advantech DVP-7010BE User Manual
  1. Manuals
  2. Brands
  3. Advantech Manuals
  4. PCI Card
  5. DVP-7010BE
  6. User manual

Advantech DVP-7010BE User Manual

4 channel pci-bus surveillance capture card
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
DVP-7010BE
4 Channel PCI-bus
Surveillance
Capture card

Advertisement

Table of Contents
loading

Related Manuals for Advantech DVP-7010BE

Summary of Contents for Advantech DVP-7010BE

  • Page 1 DVP-7010BE 4 Channel PCI-bus Surveillance Capture card...
  • Page 2 Copyright This documentation and the software included with this product are copyrighted in 2006 by Advantech Co., Ltd. All rights are reserved. Advantech Co., Ltd. reserves the right to make improvements in the products described in this manual at any time without notice.
  • Page 3 General Information...

  • Page 4: Chapter 1 General Information

    30/25 fps frame rate. DVP-7010BE supports NTSC/PAL composite video input through BNC connectors and digitizes the data to PC through PCI bus. The DVP-7010BE is a digital video surveillance card with SDK (software develop kit).It provides 4 pairs GPIO for user any kind application needs.

  • Page 5: Block Diagram

    1.3 Block Diagram Figure 1.1 System diagram 1.4 Packing List DVP-7010BE PCI capture card Utility CD (Driver, Manual, SDK, Sample, Sample source code) Connection cable for WDT...
  • Page 6 1.5 Dimensions Figure 1.2 Dimensions DVP-7010BE User’s Manual...
  • Page 7 1.6 Connector location Video input GPIO: J1 for ODM customer only Figure 1.3 connector location...
  • Page 8 Pin no. Description Pin 1 OUT0 Pin 2 OUT1 Pin 3 OUT2 Pin 4 OUT3 Pin 5 Pin 6 Pin 7 Pin 8 Pin 9 Pin 10 Table 1.1 GPIO J1 pin definition Figure 1.4 GPIO(J1) pin definition DVP-7010BE User’s Manual...

  • Page 9: Hardware Installation

    The device drivers for the DVP-7010BE board are located on the software installation CD. The auto-run function of the driver CD will guide and link you to the utilities and device drivers under Windows system.
  • Page 10 Installation Step 1: Pop-up the “System Properties” window, choose the “Hardware” page, and press the “Device Manager” bottom. DVP-7010BE User’s Manual...
  • Page 11 Step 2: Click the PC icon and press the left bottom of the mouse. Press the “Scan for hardware changes”.
  • Page 12 Step 3: The system will show the un-known devices like below window. DVP-7010BE User’s Manual...
  • Page 13 Step 4: Click the below icon to specify the driver location.
  • Page 14 Step 5: Specify the driver under the CD_ROM\driver DVP-7010BE User’s Manual...
  • Page 15 Step 6: Push the “Next” bottom to process the installation. Step 7: Continuing the installation.
  • Page 16 Step 8: Press the “Finish” bottom to finish the first circle installation. Then repeat the installation step 1~8 until all the un-known devices are all installed. DVP-7010BE User’s Manual...
  • Page 17 Step 9: From below window, we know there are 8 new items are installed.
  • Page 18 Installation of DVP-7010BE Demo Program Step 1: Install the DVP-7010BE demo program. The executive file is in the path: CD_ROM\DVP-7010B & 7020B SDK\DVP-7010B & 7020B Sample Installation DVP-7010BE User’s Manual...
  • Page 19 Step 2: Press the “Next” bottom to begin the installation.
  • Page 20 Step 3: Accept the license agreement and continue the installation. DVP-7010BE User’s Manual...
  • Page 21 Step 4: Key in your name and company name. Then press the “Next” bottom to continue. Step 5: Choose the setup type you want and next.
  • Page 22 Step 6: Beginning the installation. Step 7: Finished the installation of DVP-7010BE demo program. DVP-7010BE User’s Manual...
  • Page 23 Step 8: There will be a DVP7010B_4DEV.exe icon on the desktop. Execute the demo program. 1.10 Demo Program Functionality Below is the demo program window. The left side panels are the preview windows of video inputs. The right side panels are the function parameter settings.
  • Page 24 1.10.1 Device Each device is representative of one Conexant Fusion 878A video capture chip. User can set different parameters to different 878A chip. DVP-7010BE User’s Manual...
  • Page 25 1.10.2 Switch Channels Set the “Switch Channels” to decide how many input for each 878A video chip. Each 878A chip can switch to 4 channel video inputs to share 30/25 frame per second. For more information, please refer to “Chapter 2.5.17 AdvDVP_SetVideoInput”.
  • Page 26 To eliminate this effect, user might need to set the resolution down to 640x240 and use specific algorisms to compensate the image interlace between the scanning even field image and odd field image. For CIF/320x240 resolution, there will be no interlace effect. DVP-7010BE User’s Manual...
  • Page 28 1.10.4 Frame Rate Set the frame rate for video capturing for specific channel. Please refer to “Chapter 2.5.13 AdvDVP_SetFrameRate” DVP-7010BE User’s Manual...
  • Page 29 1.10.5 Video Mux Set the “Video Mux” to specify the video input channel for setting parameter. Please refer to “Chapter 2.5.16 AdvDVP_GetVideoInput”.
  • Page 30 1.10.6 Video Standard Set the video standard of your cameras. Please refer to “Chapter 2.5.10 AdvDVP_GetVideoFormat”. DVP-7010BE User’s Manual...
  • Page 31 1.10.7 Snap Buffer Press the “Snap Buffer” to get the image data of specific channel video input. The snap image will be show on the up panel.
  • Page 32 To set the brightness, contrast, hue and saturation of specific channel. Please refer to chapter 2.5.18 AdvDVP_SetBrightness 2.5.18 AdvDVP_GetContrast 2.5.18 AdvDVP_SetContrast 2.5.18 AdvDVP_GetHue 2.5.18 AdvDVP_SetHue 2.5.18 AdvDVP_GetSaturation 2.5.18 AdvDVP_SetSaturation 1.10.9 GPIO control To get a specified DI value or to set a specified DO value. DVP-7010BE User’s Manual...
  • Page 33 Software Function Library...
  • Page 34 Initializes the SDK AdvDVP_CloseSDK Closes up the SDK. Capture control AdvDVP_GetNoOfDevices Gets number video capture devices AdvDVP_Start Starts video capturing AdvDVP_Stop Stops video capturing AdvDVP_GetCapState Gets capture state AdvDVP_SetNewFrameCallback Sets callback function to SDK AdvDVP_GetCurFrameBuffer Gets current frame DVP-7010BE User’s Manual...

  • Page 35: Table Of Contents

    buffer Capture setting AdvDVP_GetVideoFormat Gets video input format AdvDVP_SetVideoFormat Sets video input format AdvDVP_GetFrameRate Gets frame rate AdvDVP_SetFrameRate Sets frame rate AdvDVP_GetResolution Gets video resolution AdvDVP_SetResolution Sets video resolution AdvDVP_GetVideoInput Gets video input mux AdvDVP_SetVideoInput Sets video input mux Sensor Control AdvDVP_GetBrightness Gets brightness value AdvDVP_SetBrightness...
  • Page 36 GPIO pin DVP-7010BE User’s Manual...
  • Page 37 2.2 DVP7010B/7020B Encoding Functions Library Library: DVP7010BEnc.dll Encoder: rmp4.dll Before using the DVP7010B/7020B encoding functions library, the “RMP4” codec must be installed to the system. After installing the sample program, the codec will be installed automatically. You can install the codec manually by using the “rmp4.inf”...
  • Page 38 Sets video encoding quant AdvDVP_GetVideoFrameRate Gets video encoding frame rate AdvDVP_SetVideoFrameRate Sets video encoding frame rate AdvDVP_GetVideoResolution Gets video encoding resolution AdvDVP_SetVideoResolution Sets video encoding resolution AdvDVP_GetVideoKeyInterval Gets video encoding key interval AdvDVP_SetVideoKeyInterval Sets video encoding key interval DVP-7010BE User’s Manual...
  • Page 39 2.3 DVP7010B/7020B Player Functions Library Library: DVP7010BPlayer.dll Decoder: rmp4.dll Before using the DVP7010B/7020B player functions library, the “RMP4” codec must be installed to the system. After installing the sample program, the codec will be installed automatically. You can install the codec manually by using the “rmp4.inf”...
  • Page 40 Checks if file is finished playing Playback setting AdvDVP_GetVideoResolution Gets video resolution of file AdvDVP_GetFileTime Gets total file time AdvDVP_GetPlayedTime Gets current file time AdvDVP_SetPlayPosition Locates position of file AdvDVP_GetFileTotalFrames Gets total frame number of file AdvDVP_GetPlayedFrames Gets current frame DVP-7010BE User’s Manual...
  • Page 41 number of file AdvDVP_GetPlayRate Gets current played rate - 41 -...
  • Page 42 2.4 DVP7010B/7020B Functions Reference Data Type 2.4.1 Res Syntax typedef enum tagRes SUCCEEDED = 1, FAILED = 0, SDKINITFAILED =-1, PARAMERROR =-2, NODEVICES =-3, NOSAMPLE =-4, DEVICENUMERROR =-5, INPUTERROR =-6, } Res; Description The method returned code. DVP-7010BE User’s Manual...

  • Page 43: Succeeded

    2.5 Method 2.5.1 AdvDVP_CreateSDKInstence Syntax int AdvDVP_CreateSDKInstence(void **pp) Parameters A pointer to the SDK instance. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. PARAMERROR: Parameter error. Description This function creates SDK instance. - 43 -...
  • Page 44 Function succeeded. FAILED: Function failed. NODEVICES: No devices found. Description This function initializes all video capture devices in the system. After initializing each device, the capture status would be set as “STOPPED”. See Also AdvDVP_GetNoOfDevices AdvDVP_GetCapState AdvDVP_CloseSDK DVP-7010BE User’s Manual...

  • Page 45: Sdkinitfailed

    2.5.3 AdvDVP_CloseSDK Syntax int AdvDVP_CloseSDK(void) Parameters None Return Value SUCCEEDED: Function succeeded. SDKINITFAILED: SDK not initialized. Description This function cleans all instances of capture devices and closes up the SDK. See Also AdvDVP_InitSDK - 45 -...
  • Page 46 AdvDVP_GetNoOfDevices(int *pNoOfDevs) Parameters pNoOfDevs: A pointer to get number of video capture devices. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. SDKINITFAILED: SDK not initialized. Description This function gets number of video capture devices in the system. DVP-7010BE User’s Manual...
  • Page 47 2.5.5 AdvDVP_Start Syntax int AdvDVP_Start(int nDevNum, int SwitchingChans, HWND Main, HWND hwndPreview) Parameters nDevNum: Specifies the device number(0~3). SwitchingChans: Single video input or switching between video muxes. 0: single channel. 1: two channels (mux0, mux1). 2: three channels (mux0, mux1, mux2).
  • Page 48 SwitchingChans>0), the video input mux will be set 0. See Also AdvDVP_Stop AdvDVP_GetCapState DVP-7010BE User’s Manual...
  • Page 49 2.5.6 AdvDVP_Stop Syntax int AdvDVP_Stop(int nDevNum) Parameters nDevNum: Specifies the device number(0~3). Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. SDKINITFAILED: SDK not initialized. DEVICENUMERROR: Invalid device number. Description This function stops video capturing on a specified capture port. The capture state would be set as “STOPPED”...
  • Page 50 Invalid device number. SDKINITFAILED: SDK not initialized. Description This function gets capture state of a specified capture port. typedef enum { STOPPED = 1, RUNNING = 2, UNINITIALIZED =-1, UNKNOWNSTATE } CapState; See Also AdvDVP_InitSDK AdvDVP_Start AdvDVP_Stop DVP-7010BE User’s Manual...

  • Page 51: Paramerror

    2.5.8 AdvDVP_GetCurFrameBuffer Syntax int AdvDVP_GetCurFrameBuffer(int nDevNum, long* bufSize, BYTE* buf, int VMux) Parameters nDevNum: Specifies the device number(0~3). bufSize: Frame buffer size. buf: Frame buffer. VMux: Video mux. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. SDKINITFAILED: SDK not initialized. DEVICENUMERROR: Invalid device number.
  • Page 52 ID_MUX1_NEW_FRAME 37801 #define ID_MUX2_NEW_FRAME 37802 #define ID_MUX3_NEW_FRAME 37803 nDevNum: Specifies the device number(0~3). VMux: Specifies the video mux number(0~3). bufsize: An integer pointer of the frame buffer size. buf: A BYTE pointer of the frame buffer. Return Value DVP-7010BE User’s Manual...
  • Page 53 SUCCEEDED: Function succeeded. SDKINITFAILED: SDK not initialized. DEVICENUMERROR: Invalid device number. Description This function sets a callback function to SDK. When new frame arrived, messages and frame information will be sent to callback function. See Also - 53 -...
  • Page 54 Video_SECAM_B = 0x00001000 } AnalogVideoFormat; Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. SDKINITFAILED: SDK not initialized. DEVICENUMERROR: Invalid device number. PARAMERROR: Invalid parameter. Description This function gets video input format of a specified capture port. See Also AdvDVP_SetVideoFormat DVP-7010BE User’s Manual...
  • Page 55 2.5.11 AdvDVP_SetVideoFormat Syntax int AdvDVP_SetVideoFormat(int nDevNum, AnalogVideoFormat* vFormat) Parameters nDevNum: Specifies the port device number(0~3). Vformat: video format: typedef enum tagAnalogVideoFormat Video_None = 0x00000000, Video_NTSC_M = 0x00000001, Video_NTSC_M_J = 0x00000002, Video_PAL_B = 0x00000010, Video_PAL_M = 0x00000200, Video_PAL_N = 0x00000400, Video_SECAM_B = 0x00001000 } AnalogVideoFormat;...

  • Page 56: Advdvp_Getvideoformat

    AdvDVP_GetVideoFormat DVP-7010BE User’s Manual...

  • Page 57: Advdvp_Getframerate

    2.5.12 AdvDVP_GetFrameRate Syntax int AdvDVP_GetFrameRate(int nDevNum, int *FrameRate) Parameters nDevNum: Specifies the device number(0~3). FrameRate: A pointer to get video frame rate. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. SDKINITFAILED: SDK not initialized. DEVICENUMERROR: Invalid device number. PARAMERROR: Invalid parameter. Description This function gets frame rate of a specified capture port.
  • Page 58 Function failed. SDKINITFAILED: SDK not initialized. DEVICENUMERROR: Invalid device number. PARAMERROR: Invalid parameter. Description This function sets frame rate of a specified capture port. This function should be called before “AdvDVP_Start”. If the channels share frames (i.e. DVP-7010BE User’s Manual...
  • Page 59 SwitchingChans>0), the frame rate must be set 30. Otherwise, the function will return PARAMERROR. See Also AdvDVP_GetFrameRate - 59 -...
  • Page 60 // (160x120) } VideoSize; Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. SDKINITFAILED: SDK not initialized. DEVICENUMERROR: Invalid device number. PARAMERROR: Invalid parameter. Description This function gets video resolution of a specified capture port. See Also AdvDVP_SetResolution DVP-7010BE User’s Manual...

  • Page 61: Advdvp_Getresolution

    2.5.15 AdvDVP_SetResolution Syntax int AdvDVP_SetResolution(int nDevNum, VideoSize Size) Parameters nDevNum: Specifies the device number(0~3). Size: A value to set video resolution. typedef enum FULLPAL=0, // (PAL: 768x576) SIZED1, // (NTSC: 720x480, PAL: 720x576) SIZEVGA, // (640x480) SIZEQVGA, // (320x240) SIZESUBQVGA // (160x120) } VideoSize;...

  • Page 62: Advdvp_Getvideoinput

    This function gets video input mux of a specified capture port. It returns “FAILED” when argument “SwitchingChans” of AdvDVP_Start was set nonzero. And, the video input mux will be set 0 automatically when argument “SwitchingChans” of AdvDVP_Start was set nonzero. See Also AdvDVP_Start AdvDVP_SetVideoInput DVP-7010BE User’s Manual...
  • Page 63 2.5.17 AdvDVP_SetVideoInput Syntax int AdvDVP_SetVideoInput(int nDevNum, int nInput) Parameters nDevNum: Specifies the device number(0~3). nInput: A value to set video input mux(0~3). Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. SDKINITFAILED: SDK not initialized. DEVICENUMERROR: Invalid device number. PARAMERROR: Invalid parameter. Description This function sets video input mux of a specified capture port.

  • Page 64: Inputerror

    Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. SDKINITFAILED: SDK not initialized. DEVICENUMERROR: Invalid device number. PARAMERROR: Invalid parameter. INPUTERROR: Invalid video input mux. Description This function gets brightness value of a specified capture port. See Also AdvDVP_SetBrightness DVP-7010BE User’s Manual...

  • Page 65: Advdvp_Getbrightness

    2.5.19 AdvDVP_SetBrightness Syntax int AdvDVP_SetBrightness(int nDevNum , int nInput, long lValue) Parameters nDevNum: Specifies the device number(0~3). nInput: Specifies the video input mux(-1~3). This value must be set -1 when no switching channels. lValue: A value to set brightness(0~100). Return Value SUCCEEDED: Function succeeded.

  • Page 66: Advdvp_Getcontrast

    Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. SDKINITFAILED: SDK not initialized. DEVICENUMERROR: Invalid device number. PARAMERROR: Invalid parameter. INPUTERROR: Invalid video input mux. Description This function gets contrast value of a specified capture port. See Also AdvDVP_SetContrast DVP-7010BE User’s Manual...
  • Page 67 2.5.21 AdvDVP_SetContrast Syntax int AdvDVP_SetContrast(int nDevNum, int nInput, long lValue) Parameters nDevNum: Specifies the device number(0~3). nInput: Specifies the video input mux(-1~3). This value must be set -1 when no switching channels. lValue: A value to set contrast(0~100). Return Value SUCCEEDED: Function succeeded.

  • Page 68: Advdvp_Gethue

    Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. SDKINITFAILED: SDK not initialized. DEVICENUMERROR: Invalid device number. PARAMERROR: Invalid parameter. INPUTERROR: Invalid video input mux. Description This function gets hue value of a specified capture port. See Also AdvDVP_SetHue DVP-7010BE User’s Manual...
  • Page 69 2.5.23 AdvDVP_SetHue Syntax int AdvDVP_SetHue(int nDevNum, int nInput, long lValue) Parameters nDevNum: Specifies the device number(0~3). nInput: Specifies the video input mux(-1~3). This value must be set -1 when no switching channels. lValue: A value to set hue(0~100). Return Value SUCCEEDED: Function succeeded.

  • Page 70: Advdvp_Getsaturation

    Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. SDKINITFAILED: SDK not initialized. DEVICENUMERROR: Invalid device number. PARAMERROR: Invalid parameter. INPUTERROR: Invalid video input mux. Description This function gets saturation value of a specified capture port. See Also AdvDVP_SetSaturation DVP-7010BE User’s Manual...
  • Page 71 2.5.25 AdvDVP_SetSaturation Syntax int AdvDVP_SetSaturation(int nDevNum , int nInput, long lValue) Parameters nDevNum: Specifies the device number(0~3). nInput: Specifies the video input mux(-1~3). This value must be set -1 when no switching channels. lValue: A value to set saturation(0~100). Return Value SUCCEEDED: Function succeeded.

  • Page 72: Advdvp_Gpiogetdata

    A pointer to get the value of the specified digital input. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. SDKINITFAILED: SDK not initialized. PARAMERROR: Invalid parameter. Description This function gets the value of the specified digital input. See Also AdvDVP_GPIOSetData DVP-7010BE User’s Manual...
  • Page 73 2.5.27 AdvDVP_GPIOSetData Syntax int AdvDVP_GPIOSetData(int nDONum, BOOL bValue) Parameters nDONum: Specifies the digital output number(0~3). bValue: A value to set the value of the specified digital output. Return Value SUCCEEDED: Function succeeded. FAILED: Function failed. SDKINITFAILED: SDK not initialized. PARAMERROR: Invalid parameter.
  • Page 74 2.6 DVP7010B/7020B Encoding Functions Reference Data Type 2.6.1 EncRes Syntax typedef enum tagRes ENC_SUCCEEDED = 1, ENC_FAILED = 0, ENC_SDKINITFAILED = -1, ENC_ENCINITFAILED = -2, ENC_PARAMERROR = -3, ENC_ENCNUMERROR = -4, ENC_BUFFERFULL = -5 } EncRes; Description The method returned code. DVP-7010BE User’s Manual...
  • Page 75 2.6.2 PSTREAMREADBEGIN Syntax void (*PSTREAMREADBEGIN)(int nEncNum) Parameters nEncNum: Specifies the encoder number. Return Value None Description The pointer to the Stream Read Begin callback function called when begins the video stream read process. See Also STREAMREAD_STRUCT - 75 -...
  • Page 76 #define AVIIF_KEYFRAME 0x00000010L Return Value None Description The pointer to the Stream Read Process callback function called after every video frame is encoded. User can use this function to get every encoded video frame. See Also STREAMREAD_STRUCT DVP-7010BE User’s Manual...
  • Page 77 2.6.4 PSTREAMREADEND Syntax void (*PSTREAMREADEND)(int nEncNum) Parameters nEncNum: Specifies the encoder number. Return Value None Description The pointer to the Stream Read End callback function called when the video stream read process is finished. See Also STREAMREAD_STRUCT - 77 -...

  • Page 78: Pstreamreadend

    PSTREAMREADPROC: The pointer to the Stream Read Process callback function called after every video frame is encoded. PSTREAMREADEND: The pointer to the Stream Read End callback function called when the video stream read process is finished. Description DVP-7010BE User’s Manual...
  • Page 79 This structure stores the Stream Read callback function pointers. See Also PSTREAMREADBEGIN PSTREAMREADPROC PSTREAMREADEND AdvDVP_SetStreamReadCB - 79 -...

  • Page 80: Advdvp_Createencsdkinstence

    2.7 Method 2.7.1 AdvDVP_CreateEncSDKInstence Syntax int AdvDVP_CreateEncSDKInstence (void **pp) Parameters A pointer to the encoding SDK instance. Return Value ENC_SUCCEEDED: Function succeeded. ENC_FAILED: Function failed. ENC_PARAMERROR: Parameter error. Description This function creates the encoding SDK instance. DVP-7010BE User’s Manual...

  • Page 81: Advdvp_Initsdk

    2.7.2 AdvDVP_InitSDK Syntax int AdvDVP_InitSDK(void) Parameters None Return Value ENC_SUCCEEDED: Function succeeded. Description This function initializes all parameters of the SDK in the system. See Also AdvDVP_CloseSDK - 81 -...
  • Page 82 2.7.3 AdvDVP_CloseSDK Syntax int AdvDVP_CloseSDK(void) Parameters None Return Value ENC_SUCCEEDED: Function succeeded. ENC_SDKINITFAILED: SDK does not be initialized successfully. Description This function cleans all parameters of the SDK and closes up the SDK. See Also AdvDVP_InitSDK DVP-7010BE User’s Manual...

  • Page 83: Advdvp_Initencoder

    2.7.4 AdvDVP_InitEncoder Syntax int AdvDVP_InitEncoder(int nEncNum, int nEncBufSize) Parameters nEncNum: Specifies the encoder number (0~15). nEncBufSize: Specifies the encoding buffer size. Return Value ENC_SUCCEEDED: Function succeeded. ENC_FAILED: Function failed. ENC_SDKINITFAILED: SDK does not be initialized successfully. ENC_ENCNUMERROR: Invalid encoder number. Description This function opens and initializes the specified video encoder.
  • Page 84 Invalid encoder number. ENC_ENCINITFAILED: Encoder does not be initialized successfully. Description This function closes and releases the specified video encoder. After successfully calling this function, the encoding state would be set as “ENC_UNINITIALIZED”. See Also AdvDVP_InitEncoder AdvDVP_GetState DVP-7010BE User’s Manual...

  • Page 85: Advdvp_Startvideoencode

    2.7.6 AdvDVP_StartVideoEncode Syntax int AdvDVP_StartVideoEncode(int nEncNum) Parameters nEncNum: Specifies the encoder number (0~15). Return Value ENC_SUCCEEDED: Function succeeded. ENC_FAILED: Function failed. ENC_SDKINITFAILED: SDK does not be initialized successfully. ENC_ENCNUMERROR: Invalid encoder number. ENC_ENCINITFAILED: Encoder does not be initialized successfully. Description This function notifies the specified video encoder to prepare to encode the video.
  • Page 86 Function failed. ENC_SDKINITFAILED: SDK does not be initialized successfully. ENC_ENCNUMERROR: Invalid encoder number. ENC_ENCINITFAILED: Encoder does not be initialized successfully. ENC_PARAMERROR: Parameter error. ENC_BUFFERFULL: Encoding buffer is full, the video frame can not be written to the DVP-7010BE User’s Manual...
  • Page 87 buffer. Description This function writes the video frame to the encoding buffer to encode it by the specified encoder. See Also AdvDVP_StartVideoEncode AdvDVP_StopVideoEncode - 87 -...
  • Page 88 Encoder does not be initialized successfully. Description This function notifies the specified video encoder to stop encoding and releases all relational resources. The encoding state would be set as “ENC_STOPPED” after a successful stop. See Also AdvDVP_StartVideoEncode AdvDVP_VideoEncode AdvDVP_GetState DVP-7010BE User’s Manual...
  • Page 89 2.7.9 AdvDVP_GetState Syntax int AdvDVP_GetState(int nEncNum) Parameters nEncNum: Specifies the encoder number (0~15). Return Value ENC_ENCNUMERROR: Invalid encoder number. Description This function gets encoding state of a specified video encoder. typedef enum ENC_STOPPED = 1, ENC_RUNNING = 2, ENC_UNINITIALIZED = -1, } EncoderState;...
  • Page 90 AdvDVP_SetStreamReadCB(STREAMREAD_STRU *pStreamRead) Parameters pStreamRead: A pointer to STREAMREAD_STRUCT structure recording the pointers to the StreamRead callback functions. Return Value None Description This function registers the Stream Read callback functions to the SDK. See Also STREAMREAD_STRUCT structure DVP-7010BE User’s Manual...
  • Page 91 2.7.11 AdvDVP_GetVideoQuant Syntax int AdvDVP_GetVideoQuant(int nEncNum, int *nQuant) Parameters nEncNum: Specifies the encoder number (0~15). nQuant: A pointer to get the video quant. The range is 1~31. The default video quality is 4. Return Value ENC_SUCCEEDED: Function succeeded. ENC_FAILED: Function failed. ENC_SDKINITFAILED: SDK does not be initialized...
  • Page 92 Encoder does not be initialized successfully. Description This function sets video quant of the specified video encoder. The lower video quant can get the compressed video with higher quality and bit rate, vice versa. See Also AdvDVP_GetVideoQuant DVP-7010BE User’s Manual...
  • Page 93 2.7.13 AdvDVP_GetVideoFrameRate Syntax int AdvDVP_GetVideoFrameRate(int nEncNum, int *nFrameRate) Parameters nEncNum: Specifies the encoder number (0~15). nFrameRate: A pointer to get the video frame rate. Return Value ENC_SUCCEEDED: Function succeeded. ENC_FAILED: Function failed. ENC_SDKINITFAILED: SDK does not be initialized successfully. ENC_ENCNUMERROR: Invalid encoder number.
  • Page 94 Function succeeded. ENC_FAILED: Function failed. ENC_SDKINITFAILED: SDK does not be initialized successfully. ENC_ENCNUMERROR: Invalid encoder number. ENC_ENCINITFAILED: Encoder does not be initialized successfully. Description This function sets video frame rate of the specified video encoder. See Also AdvDVP_GetVideoFrameRate DVP-7010BE User’s Manual...
  • Page 95 2.7.15 AdvDVP_GetVideoResolution Syntax int AdvDVP_GetVideoResolution(int nEncNum, int *nWidth, int *nHeight) Parameters nEncNum: Specifies the encoder number (0~15). nWidth: A pointer to get the width of the video. nHeight: A pointer to get the height of the video. Return Value ENC_SUCCEEDED: Function succeeded.
  • Page 96 Function succeeded. ENC_FAILED: Function failed. ENC_SDKINITFAILED: SDK does not be initialized successfully. ENC_ENCNUMERROR: Invalid encoder number. ENC_ENCINITFAILED: Encoder does not be initialized successfully. Description This function sets video resolution of the specified video encoder. See Also AdvDVP_GetVideoResolution DVP-7010BE User’s Manual...
  • Page 97 2.7.17 AdvDVP_GetVideoKeyInterval Syntax int AdvDVP_GetVideoKeyInterval(int nEncNum, int *nKeyInterval) Parameters nEncNum: Specifies the encoder number (0~15). nKeyInterval: A pointer to get the interval of the video key frame. Return Value ENC_SUCCEEDED: Function succeeded. ENC_FAILED: Function failed. ENC_SDKINITFAILED: SDK does not be initialized successfully.
  • Page 98 ENC_SDKINITFAILED: SDK does not be initialized successfully. ENC_ENCNUMERROR: Invalid encoder number. ENC_ENCINITFAILED: Encoder does not be initialized successfully. Description This function sets the interval of the video key frame of the specified video encoder. See Also AdvDVP_GetVideoKeyInterval DVP-7010BE User’s Manual...

  • Page 99: Advdvp_Createavifile

    2.7.19 AdvDVP_CreateAVIFile Syntax HANDLE AdvDVP_CreateAVIFile(LPCSTR lpcsFileName, int nWidth, int nHeight, int nFrameRate) Parameters lpcsFileName: Specifies the file name of the AVI file. nWidth: nHeight nFrameRate Specifies the frame rate of the video. Return Value If the function succeeds, the file handle is returned. Otherwise, the function returns NULL.
  • Page 100 #define AVIIF_KEYFRAME 0x00000010L Return Value ENC_SUCCEEDED: Function succeeded. ENC_FAILED: Function failed. ENC_SDKINITFAILED: SDK does not be initialized successfully. Description This function writes the video stream data into the specified AVI file. See Also AdvDVP_CreateAVIFile DVP-7010BE User’s Manual...
  • Page 101 AdvDVP_CloseAVIFile - 101 -...
  • Page 102 AdvDVP_CloseAVIFile(HANDLE hAVIFile) Parameters hAVIFile: Specifies the AVI file handle. Return Value ENC_SUCCEEDED: Function succeeded. ENC_FAILED: Function failed. ENC_SDKINITFAILED: SDK does not be initialized successfully. Description This function closes the specified AVI file. See Also AdvDVP_CreateAVIFile AdvDVP_WriteAVIFile DVP-7010BE User’s Manual...
  • Page 103 2.8 DVP7010B/7020B Player Functions Reference Data Type 2.8.1 PlayerRes Syntax typedef enum tagRes PLAYER_SUCCEEDED = 1, PLAYER_FAILED = 0, PLAYER_SDKINITFAILED = -1, PLAYER_PARAMERROR = -2, } PlayerRes; Description The method returned code. - 103 -...
  • Page 104 2.9 Method 2.9.1 AdvDVP_CreatePlayerSDKInstence Syntax int AdvDVP_CreatePlayerSDKInstence(void **pp) Parameters A pointer to the player SDK instance. Return Value PLAYER_SUCCEEDED: Function succeeded. PLAYER_FAILED: Function failed. PLAYER_PARAMERROR: Parameter error. Description This function creates playback SDK instance. DVP-7010BE User’s Manual...
  • Page 105 2.9.2 AdvDVP_OpenFile Syntax int AdvDVP_OpenFile(LPCSTR lpcsFileName) Parameters lpcsFileName: Specifies the file name of the source video file. Return Value PLAYER_SUCCEEDED: Function succeeded. PLAYER_FAILED: Function failed. Description This function opens the source video file and initializes the video player. The playback status would be set as “PLAYER_STOPPED”...
  • Page 106 Function succeeded. PLAYER_FAILED: Function failed. Description This function closes the source video file and free resources allocated for video player. The playback status would be set as “PLAYER_NOTOPENED” after successfully calling this function. See Also AdvDVP_OpenFile AdvDVP_GetStatus DVP-7010BE User’s Manual...

  • Page 107: Advdvp_Stop

    2.9.4 AdvDVP_Play Syntax int AdvDVP_Play(HWND hwndApp, BOOL bAutoResizeWnd) Parameters hwndApp: A windows handle for display area. bAutoResizeWnd: Specifies if the display area is resized automatically according to the video resolution. Return Value PLAYER_SUCCEEDED: Function succeeded. PLAYER_FAILED: Function failed. Description This function plays the file that has been opened. The playback status would be set as “PLAYER_PLAYING”...
  • Page 108 Return Value PLAYER_SUCCEEDED: Function succeeded. PLAYER_FAILED: Function failed. Description This function pauses or continues the file that has been opened. The playback status would be set as “PLAYER_PAUSED” after successfully calling this function. See Also AdvDVP_Play AdvDVP_Stop AdvDVP_GetStatus DVP-7010BE User’s Manual...
  • Page 109 2.9.6 AdvDVP_Stop Syntax int AdvDVP_Stop() Parameters None. Return Value PLAYER_SUCCEEDED: Function succeeded. PLAYER_FAILED: Function failed. Description This function stops the file that is playing. The playback status would be set as “PLAYER_STOPPED” after successfully calling this function. See Also AdvDVP_Play AdvDVP_Pause AdvDVP_GetStatus - 109 -...

  • Page 110: Advdvp_Fast

    PLAYER_FAILED: Function failed. Description This function improves the current play speed by one time, 4 times at most. The playback status would be set as “PLAYER_PLAYING” after successfully calling this function. See Also AdvDVP_Pause AdvDVP_Stop AdvDVP_Slow AdvDVP_GetStatus DVP-7010BE User’s Manual...
  • Page 111 2.9.8 AdvDVP_Slow Syntax int AdvDVP_Slow() Parameters None. Return Value PLAYER_SUCCEEDED: Function succeeded. PLAYER_FAILED: Function failed. Description This function slows the current play speed by one time, 4 times at most. The playback status would be set as “PLAYER_PLAYING” after successfully calling this function.

  • Page 112: Advdvp_Playstep

    Return Value PLAYER_SUCCEEDED: Function succeeded. PLAYER_FAILED: Function failed. Description This function makes the video to step forward one frame. The playback status would be set as “PLAYER_PAUSED” after successfully calling this function. See Also AdvDVP_Pause AdvDVP_Stop AdvDVP_GetStatus DVP-7010BE User’s Manual...
  • Page 113 2.9.10 AdvDVP_GetStatus Syntax int AdvDVP_GetStatus () Parameters None Return Value PLAYER_SUCCEEDED: Function succeeded. PLAYER_FAILED: Function failed. Description This function gets playback status. typedef enum tagPlayerStatus{ PLAYER_NOTOPENED = 0, PLAYER_OPENED = 1, PLAYER_PLAYING = 2, PLAYER_STOPPED = 3, PLAYER_PAUSED } PlayerStatus; See Also AdvDVP_OpenFile AdvDVP_CloseFile...

  • Page 114: Advdvp_Getcurimage

    *pBufSize) Parameters lpImage: A pointer to a image buffer. pBufSize: A long pointer to receive the returned image buffer size. Return Value PLAYER_SUCCEEDED: Function succeeded. PLAYER_FAILED: Function failed. Description This function gets current played image. See Also DVP-7010BE User’s Manual...

  • Page 115: Advdvp_Regnotifymsg

    2.9.12 AdvDVP_RegNotifyMsg Syntax int AdvDVP_RegNotifyMsg(HWND hWnd, UINT nMsg) Parameters hWnd: Specifies the handle of the window receiving this message. nMsg: Specifies the user-define message. When this message is received, it means some event of the playback occur such as the file playing is end.

  • Page 116: Advdvp_Checkfileend

    See Also AdvDVP_CheckFileEnd DVP-7010BE User’s Manual...
  • Page 117 2.9.13 AdvDVP_CheckFileEnd Syntax BOOL AdvDVP_CheckFileEnd () Parameters None Return Value If the event that the file playing end is detected, this function returns TRUE. Otherwise, the function returns FALSE. Description This function checks if the file playing is end. See Also AdvDVP_RegNotifyMsg - 117 -...

  • Page 118: Advdvp_Getvideoresolution

    An integer pointer to get the height of the video. Return Value PLAYER_SUCCEEDED: Function succeeded. PLAYER_FAILED: Function failed. Description This function gets width and the height of the video. See Also DVP-7010BE User’s Manual...
  • Page 119 2.9.15 AdvDVP_GetPlayRate Syntax double AdvDVP_GetPlayRate() Parameters None Return Value If the function succeeded, the playback ratio is returned. Otherwise, the function returns 0. Description This function retrieves the playback rate. See Also AdvDVP_Play AdvDVP_Fast AdvDVP_Slow - 119 -...

  • Page 120: Advdvp_Getfiletime

    2.9.16 AdvDVP_GetFileTime Syntax double AdvDVP_GetFileTime() Parameters None Return Value If the function succeeded, the total file time is returned. Otherwise, the function returns 0. Description This function retrieves total file time in seconds. See Also AdvDVP_GetPlayedTime AdvDVP_SetPlayPosition DVP-7010BE User’s Manual...
  • Page 121 2.9.17 AdvDVP_GetPlayedTime Syntax double AdvDVP_GetPlayedTime() Parameters None Return Value If the function succeeded, the current file time is returned. Otherwise, the function returns 0. Description This function retrieves current file time in seconds. See Also AdvDVP_GetFileTime AdvDVP_SetPlayPosition - 121 -...
  • Page 122 2.9.18 AdvDVP_SetPlayPosition Syntax int AdvDVP_SetPlayPosition (double dTime) Parameters dTime: Specifies the file time in seconds. Return Value PLAYER_SUCCEEDED: Function succeeded. PLAYER_FAILED: Function failed. Description This function seeks the file to the specified file time. See Also AdvDVP_GetFileTime AdvDVP_GetPlayedTime DVP-7010BE User’s Manual...
  • Page 123 2.9.19 AdvDVP_GetFileTotalFrames Syntax LONGLONG AdvDVP_GetFileTotalFrames() Parameters None Return Value If the function succeeded, the total number of the frame of the file is returned. Otherwise, the function returns 0. Description This function retrieves total number of the frame of the file. See Also AdvDVP_GetPlayedFrames - 123 -...
  • Page 124 Syntax LONGLONG AdvDVP_GetPlayedFrames() Parameters None Return Value If the function succeeded, the current frame number of the file is returned. Otherwise, the function returns Description This function retrieves current frame number of the file. See Also AdvDVP_GetFileTotalFrames DVP-7010BE User’s Manual...

Table of Contents