ADLINK Technology HDV62A Library Reference Manual
  1. Manuals
  2. Brands
  3. ADLINK Technology Manuals
  4. PCI Card
  5. HDV62A
  6. Library reference manual

ADLINK Technology HDV62A Library Reference Manual

High-definition video/audio capture cardhigh-definition video/audio capture card
Hide thumbs Also See for HDV62A:
Table of Contents

Advertisement

Quick Links

Download this manual
High-Definition Video/Audio Capture Card
Function Library Reference
Revision:
Revision Date:
Part No:
Advance Technologies; Automate the World.
HDV62A
2.00
Nov.23, 2012
50-11248-1000

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the HDV62A and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for ADLINK Technology HDV62A

Summary of Contents for ADLINK Technology HDV62A

  • Page 1 HDV62A High-Definition Video/Audio Capture Card Function Library Reference 2.00 Revision: Nov.23, 2012 Revision Date: 50-11248-1000 Part No: Advance Technologies; Automate the World.
  • Page 2 Revision History Revision Release Date Description of Change(s) 2.00 Nov. 23, 2012 Initial Release...

  • Page 3: Preface

    HDV62A-FLR Preface Copyright 2012 ADLINK Technology, Inc. This document contains proprietary information protected by copy- right. All rights are reserved. No part of this manual may be repro- duced by any mechanical, electronic, or other means in any form without prior written permission of the manufacturer.
  • Page 4 Conventions Take note of the following conventions used throughout this reference to make sure that users perform certain tasks and instructions properly. Additional information, aids, and tips that help users perform tasks. NOTE: NOTE: Information to prevent minor physical injury, component dam- age, data loss, and/or program corruption when trying to com- plete a task.

  • Page 5: Table Of Contents

    HDV62A-FLR Table of Contents Revision History ..............ii Preface ..................iii List of Figures ................ ix List of Tables................xi 1 Introduction ................ 1 Overview................1 Features................1 2 Function Library ..............3 List of Functions..............3 Setting Up the Build Environment........6 2.2.1...
  • Page 6 2.4.1 Channel ..............16 2.4.2 Sensor Format ............17 2.4.3 Sensor Width ............22 2.4.4 Sensor Height ............23 2.4.5 Width ................ 24 2.4.6 Height ............... 25 2.4.7 X Offset..............26 2.4.8 Y Offset..............27 2.4.9 Output Format............28 2.4.10 HDelay ..............
  • Page 7 HDV62A-FLR 2.6.8 Sensor Status ............56 2.6.9 Save Image .............. 57 2.6.10 Audio Stream............58 Other Functions ..............59 2.7.1 Error Text..............59 EDID Functions..............60 2.8.1 Ready Status ............60 2.8.2 Access Permission ........... 62 2.8.3 Write Protection ............63 2.8.4...
  • Page 8 This page intentionally left blank. viii Table of Contents...

  • Page 9: List Of Figures

    HDV62A-FLR List of Figures Figure 2-1: Image Layout............23 Figure 2-2: Bottom-up Image Orientation ........45 Figure 2-3: Top-down Image Orienation ........46 Figure 2-4: EDID ROM Architecture ........... 62 List of Figures...
  • Page 10 This page intentionally left blank. List of Figures...

  • Page 11: List Of Tables

    HDV62A-FLR List of Tables Table 2-1: API Functions ..............6 List of Tables...
  • Page 12 This page intentionally left blank. List of Tables...

  • Page 13: Introduction

    HDV62A-FLR Introduction 1.1 Overview The HDV62A full HD video/audio capture card, based on the PCI ® Express x4 interface, enables acquisition of video and digital audio streams from both HD (high-definition) and SD (stan- dard-definition) video at up to 170 MHz DVI input.
  • Page 14 This page intentionally left blank. Introduction...

  • Page 15: Function Library

    DirectShow technologies can alternativerly be utilized, as described in the HDV62A User’s Manual, to program applications. Please note that the API and DirectShow programming cannot be combined to access a single HDV62A card at the same time. 2.1 List of Functions Category...
  • Page 16 Category Function Name Image Format Hdv62_SetChannel Control Hdv62_GetChannel Hdv62_SetSensorFormat Hdv62_GetSensorFormat Hdv62_GetSensorWidth Hdv62_GetSensorHeight Hdv62_SetWidth Hdv62_GetWidth Hdv62_SetHeight Hdv62_GetHeight Hdv62_SetXOffset Hdv62_GetXOffset Hdv62_SetYOffset Hdv62_GetYOffset Hdv62_SetOutputFormat Hdv62_GetOutputFormat Hdv62_SetHDelay Hdv62_GetHDelay Hdv62_SetContrast Hdv62_GetContrast Hdv62_SetHue Hdv62_GetHue Hdv62_SetSaturation Hdv62_GetSaturation Hdv62_SetBrightness Hdv62_GetBrightness Hdv62_GetDetectedSensorFormat Hdv62_GetHdmiSensorResolution Hdv62_GetSDSensorResolution Hdv62_GetAnalogSensorResolution Hdv62_GetVideoCapabilities Hdv62_SetImageOrientation Hdv62_GetImageOrientation Function Library...
  • Page 17 HDV62A-FLR Category Function Name Event & Callback Hdv62_SetEventSelector Hdv62_GetEventSelector Hdv62_SetEventHandle Hdv62_GetEventHandle Hdv62_SetCallbackSelector Hdv62_GetCallbackSelector Hdv62_SetCallback Acquisition Control Hdv62_SetAcquisitionFrameCount Hdv62_GetAcquisitionFrameCount Hdv62_AcquisitionStart Hdv62_AcquisitionStop Hdv62_OneShot Hdv62_GetImageStream Hdv62_GetAcquisitionStatus Hdv62_GetAcquisitionStatistics Hdv62_GetSensorStatus Hdv62_SaveImage Hdv62_GetAudioStream Others Hdv62_GetErrorText EDID Hdv62_SetEdidReadyStatus Hdv62_GetEdidReadyStatus Hdv62_SetEdidAccessPermission Hdv62_GetEdidAccessPermission Hdv62_SetEdidWriteProtection Hdv62_GetEdidWriteProtection Hdv62_SetEdidRomSelector Hdv62_GetEdidRomSelector Hdv62_SetEdidRom Hdv62_GetEdidRom...

  • Page 18: Setting Up The Build Environment

    Category Function Name Audio Format Hdv62_SetAudioInput Control Hdv62_GetAudioInput Hdv62_SetAudioChannels Hdv62_GetAudioChannels Hdv62_SetAudioSamplesPerSec Hdv62_GetAudioSamplesPerSec Hdv62_SetAudioBitsPerSample Hdv62_GetAudioBitsPerSample Hdv62_GetAudioCapabilities Table 2-1: API Functions 2.2 Setting Up the Build Environment 2.2.1 Include Files All applications using API are required to include the following files. Include File The header file required for all C/C++ Hdv62.h...

  • Page 19: Dll Files

    All files are located in the directory \ADLINK\hdv62\Include 2.3 Device Control Functions 2.3.1 Device Count Returns the total number of HDV62A devices in the system, with a maximum of 16 devices detectable. Syntax C/C++ int Hdv62_GetDeviceCount(UINT &Count) int GetDeviceCount(out uint Count) VB.Net...

  • Page 20: Device Open

    Parameter(s) Count The total number of devices installed. Return Value No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error informa- tion. 2.3.2 Device Open Initializes a specified device. Should be called before other functions except those with no Number parameter.

  • Page 21: Device Vendor Name

    HDV62A-FLR Syntax C/C++ int Hdv62_DeviceClose (UINT Number) int DeviceClose (uint Number) VB.Net DeviceClose (ByVal Number UInteger) Integer Parameter(s) Number The number of the device to be closed, with allowed values from 0 to 15. Return Value No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error informa- tion.

  • Page 22: Device Model Name

    Number The number of the device, with allowed values from 0 to 15. Name Points to a user-allocated buffer into which the function cop- ies the model name string, for example, “HDV62A”. The name is NULL-terminated. Return Value C/C++ Function Library...

  • Page 23: Device Version

    HDV62A-FLR No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error informa- tion. Return model name. VB.Net Return model name. 2.3.6 Device Version Retrieves or returns the version of the hardware device.

  • Page 24: Device Firmware Version

    No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error informa- tion. Return version string. VB.Net Return version string. 2.3.7 Device Firmware Version Retrieves or returns the version of the firmware. Syntax C/C++ int Hdv62_GetDeviceFirmwareVersion (UINT Num-...

  • Page 25: Driver Version

    HDV62A-FLR Return version string. VB.Net Return version string. 2.3.8 Driver Version Retrieves or returns the driver version. Syntax C/C++ int Hdv62_GetDriverVersion (UINT Number, char *Version) string GetDriverVersion (uint Number) VB.Net GetDriverVersion (ByVal Number as UInteger) As String Parameter(s) Number The number of the device, with allowed values from 0 to 15.

  • Page 26: Library Version

    2.3.9 Library Version Retrieves or returns the library version. Syntax C/C++ int Hdv62_GetLibraryVersion (UINT Number, char *Version) string GetLibraryVersion (uint Number) VB.Net GetLibraryVersion (ByVal Number as UInteger) As String Parameter(s) Number The number of the device, with allowed values from 0 to 15. Version Points to a user-allocated buffer into which the version string is entered, such as “1.2.2.1”.

  • Page 27: Device Reset

    2.3.11 Device Reset Restores the HDV62A to its initial boot state, after which all settings must be reconfigured. Call only when the device behaves abnormally and will not restore. The effect of this func- tion is essentiually that of a reboot in less time.

  • Page 28: Image Format Control Functions

    2.4.1 Channel Sets or retrieves channel of device, based on multi-source inputs, only one of which is available at one time. The desired channel should be selected. Please see the HDV62A User’s Manual for source input connections. Syntax C/C++ int Hdv62_SetChannel (UINT Number, UINT Chan- nel) int Hdv62_GetChannel (UINT Number, UINT &Chan-...

  • Page 29: Sensor Format

    HDV62A-FLR The number of the device, with allowed values from 0 to 15. Channel Input Source, with 5 allowed values from 0 to 4, for: 0. Analog RGB signal from DVI-I connector 1. YPbPr signal from external I/O bracket 2. HDMI signal from DVI-I connector 3.
  • Page 30 Parameter(s) Number The number of the device, with allowed values from 0 to 15. Format Source input format, with values differing by channel as: Channel 0: Analog RGB signal from DVI-I connector 0: VGA 60 fps (640 x 480) 1: SVGA 60 fps (800 x 600) 2: XVGA 60 fps (1024 x 768) 3: SXVGA 60 fps (1280 x 1024) 4 : UXGA 60fps (1600 x 1200)
  • Page 31 HDV62A-FLR 21 : Wide XGA 60fps (1360 x768) 22 : SXGA+ 60fps (1400 x 1050) 23 : SXGA+ 75fps (1400 x 1050) Channel 1: YPbPr signal from external I/O bracket 0: 525i 30 fps (720 x 480 interlace, in frames per second)
  • Page 32 8: VGA 60 fps (640 x 480) 9: SVGA 60 fps (800 x 600) 10: XGA 60 fps (1024 x 768) 11: SXGA 60 fps (1280 x 1024) 12: UXGA 60 fps (1600 x 1200) 13: 720p 50 fps RGB In (1280 x 720 progressive) 14: 720p 60 fps RGB In (1280 x 720 progressive) 15: 1080i 25 fps RGB In (1920 x 1080 interlace, in frames per second)
  • Page 33 HDV62A-FLR 33: 525i 30 fps RGB In (720 x 480 interlace, in frame per second) 34: 625i 25 fps RGB In (720 x 576 interlace, in frame per second) 35: WXGA+ 60 fps RGB In (1280 x 768) 36: WSXGA+ 60 fps RGB In (1680 x 1050)

  • Page 34: Sensor Width

    5: PAL Nc Final resolutions of channels 0,1, and 2 can be acquired with GetVideoCapabilities() Noise and black images lasting for a few sec- NOTE: NOTE: onds (actual time of noise and black images depends on the source) may occur if the input source is HDMI plus HDCP, and can be pre- vented by delaying commencing capture for a few seconds after initial connection of the HDMI...

  • Page 35: Sensor Height

    HDV62A-FLR The image width of source input as shown. Figure 2-1: Image Layout Return Value No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error information. 2.4.4 Sensor Height Acquires image height of the source input, the same value as shown in Sensor Format.

  • Page 36: Width

    VB.Net GetSensorHeight (ByVal Number UInteger, ByRef Height as UInteger) As Integer Parameter(s) Number The number of the device, with allowed values from 0 to 15. Height The image height of source input as shown. Return Value No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error information.

  • Page 37: Height

    HDV62A-FLR Active width of the image as shown, the width coupled with XOffset acting as cropping parameters. The device crops the sensor image if the width is less than SensorWidth, according ≦ Width SensorWidth ≦ Width + XOffset SensorWidth Width must be a multiple of 16 pixels Return Value No error occurs if return value ≥...

  • Page 38: Offset

    Active height of the image as shown, which when coupled with YOffset, acts as cropping parameters. The device crops the sensor image if the height is less than SensorHeight, according to: Height <= SensorHeight Height + YOffset <= SensorHeight Height is an even number. YOffset is an even number if sensor source is interlaced.

  • Page 39: Yoffset

    HDV62A-FLR Start pixels of image cropping per line as shown, which, when coupled with Width, act as cropping parameters. The device crops sensor image if the XOffset exceeeds 0, accord- ing to: Width <= SensorWidth Width + XOffset <= SensorWidth...

  • Page 40: Output Format

    Image cropping start lines, as shown, which, coupled with Height, act as cropping parameters. The device crops sensor image if the YOffset exceeds 0, according to: Height <= SensorHeight Height + YOffset <= SensorHeight Height is an even number YOffset is an even number if sensor source is interlaced Return Value No error occurs if return value ≥...
  • Page 41 HDV62A-FLR Pixel output format, one of (wherin x denotes neutral bit): 0: 24bit RGB (RGB24) – 8bit R + 8bit G + 8bit B Pixel Data [31:0] DWORD [31:24] [23:16] [15:8] [7:0] 1: 30bit RGB (BGR30) - 10bit R + 10bit G + 10bit B...
  • Page 42 NOTE: Total bytes of one scan line must align with a multiple of 16. If the requirement is not met, the HDV62A appends dummy bytes to the end of each line, for example, if 20bit YCbCr 4:2:2 is selected and:...

  • Page 43: Hdelay

    HDV62A-FLR Return Value No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error information. 2.4.10 HDelay Sets or retrieves horizontal delay of frame images, similar to X offset, shifting images left or right to remove black vertical lines.

  • Page 44: Contrast

    2.4.11 Contrast Sets or retrieves contrast of input YPbPr frame images. Syntax C/C++ int Hdv62_SetContrast (UINT Number, int Value) Hdv62_GetContrast (UINT Number, & Value) int SetContrast (uint Number, int Value) int GetContrast (uint Number, out int Value) VB.Net SetContrast (ByVal Number as UInteger, ByVal Value as Integer) As Integer GetContrast (ByVal Number as UInteger, ByRef Value as Integer) As Integer...

  • Page 45: Saturation

    HDV62A-FLR int SetHue (uint Number, int Value) int GetHue (uint Number, out int Value) VB.Net SetHue (ByVal Number as UInteger, ByVal Value as Integer) As Integer GetHue (ByVal Number as UInteger, ByRef Value as Integer) As Integer Parameter(s) Number The number of the device, with allowed values from 0 to 15.

  • Page 46: Brightness

    GetSaturation (ByVal Number as UInteger, ByRef Value as Integer) As Integer Parameter(s) Number The number of the device, with allowed values from 0 to 15. Value Frame image saturation, with allowed values from 0 to 255 and default value 128. Return Value No error occurs if return value ≥...

  • Page 47: Hdmisensorresolution

    HDV62A-FLR Brightness of frame images, with allowed values from -128 to 127 and default value 0. Return Value No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error information.

  • Page 48: Sdsensorresolution

    UINT Interlace; } SENSOR_RESOLUTION; public struct SENSOR_RESOLUTION public uint Width; public uint Height; public uint FrameRate; public uint Interlace; VB.Net Public Structure SENSOR_RESOLUTION Public Width As UInteger Public Height As UInteger Public FrameRate As UInteger Public Interlace As UInteger End Structure SD format (525i and 625i) may exceed the defined width, such as 625i being 720 x 576, but 1440 x 576 is usable from this function.

  • Page 49: Analogsensorresolution

    HDV62A-FLR Syntax C/C++ Hdv62_GetSDSensorResolution(UINT Number, int& Value) int GetSDSensorResolution (uint Number, int Value) VB.Net GetSDSensorResolution (ByVal Number as UInte- ger, ByRef Value As Integer) As Integer Parameter(s) Value Read back resolution of the sensor, defined as: 0: NTSC MJ 1: PAL 60 2: NTSC 4.43...
  • Page 50 int Hdv62_GetAnalogSensorResolution(UINT Num- ber, SENSOR_RESOLUTION& Resolution) GetAnalogSensorResolution (uint Number, out SENSOR_RESOLUTION Resolution) VB.Net GetAnalogSensorResolution (ByVal Number UInteger, ByRef Resolution SENSOR_RESOLUTION) As Integer Parameter(s) Number The number of the device, with allowed values from 0 to 15. SENSOR_RESOLUTION Structure of analog sensor resolution, defined as: C/C++ typedef struct _SENSOR_RESOLUTION UINT Width;...

  • Page 51: Video Capabilities

    HDV62A-FLR public uint Interlace; VB.Net Public Structure SENSOR_RESOLUTION Public Width As UInteger Public Height As UInteger Public FrameRate As UInteger Public Interlace As UInteger End Structure Return Value No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error information.
  • Page 52 RESOLUTION_CAPABILITIES Supported resolutions defined as: C/C++ typedef struct _SENSOR_PROPERTIES char Name[ 256 ]; unsigned long Width; unsigned long Height; unsigned long FrameRate; unsigned long Interlace; unsigned long Hf; unsigned long HTotal; unsigned long Hsw; unsigned long Hbp; unsigned long Vf; unsigned long VTotal;...
  • Page 53 HDV62A-FLR SENSOR_PROPERTIES *HdmiResolutions; } RESOLUTION_CAPABILITIES; struct SENSOR_PROPERTIES // name MarshalAs(UnmanagedType.ByValTStr, SizeConst = 256)] public string Name; // video setting public uint Width; public uint Height; public uint FrameRate; public uint Interlace; // video timing public uint Hf;// horizontal frequency public uint HTotal;// horizontal total line public uint Hsw;// horizontal sync width...
  • Page 54 public uint NumRgbResolution; public IntPtr RgbResolutions; public uint NumYPbPrResolution; public IntPtr YPbPrResolutions; public uint NumHdmiResolution; public IntPtr HdmiResolutions; VB.Net Structure SENSOR_PROPERTIES <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=256)> _ Dim Name As String Dim Width As UInteger Dim Height As UInteger Dim FrameRate As UInteger Dim Interlace As UInteger Dim Hf As UInteger ' horizontal frequency...

  • Page 55: Image Orientaton

    HDV62A-FLR Dim Vsw As UInteger ' vertical sync width Dim Vbp As UInteger ' vertical back porch End Structure Structure RESOLUTION_CAPABILITIES Dim NumRgbResolution As UInteger Dim RgbResolutions As IntPtr Dim NumYPbPrResolution As UInteger Dim YPbPrResolutions As IntPtr Dim NumHdmiResolution As UInteger...
  • Page 56 SetImageOrientation (uint Number, uint Value) int GetImageOrientation (uint Number, out uint Value) VB.Net SetImageOrientation (ByVal Number as UInteger, ByVal Value As UInteger) As Integer GetImageOrientation (ByVal Number as UInteger, ByRef Value As UInteger) As Integer Parameter(s) Number The number of the device, with allowed values from 0 to 15. Value Indicates the image orientation, from among: 0: Bottom-up, in which the image buffer starts with the bot-...

  • Page 57: Figure 2-2: Bottom-Up Image Orientation

    HDV62A-FLR E.g. Color space = RGB24 Image Width Start of buffer … bottom left pixel … … … … top left pixel Figure 2-2: Bottom-up Image Orientation 1: Top-down, in which order of the row is reversed, with top row of the image the first row in memory, followed by the next row down, with bottom row of the image the last row in the buf- fer, such that first byte in memory is the top-left of the image.

  • Page 58: Event And Callback Functions

    E.g. Color space = RGB24 Image Width Start of buffer … top left pixel … … … … bottom left pixel Figure 2-3: Top-down Image Orienation Return Value No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error information.

  • Page 59: Event Handle

    HDV62A-FLR int SetEventSelector (uint Number, uint Mode) int GetEventSelector (uint Number, out uint Mode) VB.Net SetEventSelector (ByVal Number UInteger, ByVal Mode as UInteger) As Integer GetEventSelector (ByVal Number UInteger, ByRef Mode as UInteger) As Integer Parameter(s) Number The number of the device, with allowed values from 0 to 15.
  • Page 60 int Hdv62_GetEventHandle (UINT Number, HANDLE &Handle) int SetEventHandle (uint Number, IntPtr Han- dle) int SetEventHandle (uint Number, SafeWaitHan- dle Handle) int GetEventHandle (uint Number, out IntPtr Handle) int GetEventHandle (uint Number, out SafeWait- Handle Handle) VB.Net SetEventHandle (ByVal Number UInteger, ByVal Handle as IntPtr) As Integer SetEventHandle (ByVal...

  • Page 61: Callbackselector

    HDV62A-FLR 2.5.3 CallbackSelector Sets or retrieves callback function type. Syntax C/C++ Hdv62_SetCallbackSelector (UINT Number, UINT Mode) Hdv62_GetCallbackSelector (UINT Number, UINT Mode) SetCallbackSelector (uint Number, uint Mode) int GetCallbackSelector (uint Number, out uint Mode) VB.Net SetCallbackSelector (ByVal Number as UInteger, ByVal Mode as UInteger) As Integer...

  • Page 62: Callback

    2.5.4 Callback Sets or retreives callback handle. While event and callback are the most frequently used methods determining when to recover frame or audio information, only one is normally allowed, but here both can be set. Syntax C/C++ Hdv62_SetCallback (UINT Number, HDV62CALLBACK Fun) SetCallback...

  • Page 63: Acquisition Control Functions

    HDV62A-FLR 2.6 Acquisition Control Functions 2.6.1 Acquisition Frame Count Sets or retrieves the number of frames to be simulatane- ously captured. Call: AcquisitionStart to initiate capture GetAcquisitionStatus to retreive acquisition state AcquisitionStop to terminate capture Syntax C/C++ int Hdv62_SetAcquisitionFrameCount (UINT Num-...

  • Page 64: Acquisition Start

    Return Value No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error information. 2.6.2 Acquisition Start Initiates frame capture Syntax C/C++ int Hdv62_AcquisitionStart (UINT Number) int AcquisitionStart (uint Number) VB.Net AcquisitionStart (ByVal Number as UInteger) As Integer...

  • Page 65: One Shot

    HDV62A-FLR int AcquisitionStop (uint Number) VB.Net AcquisitionStop (ByVal Number as UInteger) As Integer Parameter(s) Number The number of the device, with allowed values from 0 to 15. Return Value No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error informa- tion.

  • Page 66: Image Stream

    Return Value No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error informa- tion. 2.6.5 Image Stream Retreives the image buffer pointer. Usually called during callback, after waiting for a frame event, or after calling One- Shot.

  • Page 67: Acquisition Statistics

    HDV62A-FLR Syntax C/C++ Hdv62_GetAcquisitionStatus (UINT Number, UINT &Status) GetAcquisitionStatus (uint Number, uint Status) VB.Net GetAcquisitionStatus (ByVal Number as UInte- ger, ByRef Status as UInteger) As Integer Parameter(s) Number The number of the device, with allowed values from 0 to 15.

  • Page 68: Sensor Status

    VB.Net GetAcquisitionStatistics (ByVal Number as UIn- teger, ByRef Count as UInteger) As Integer Parameter(s) Number The number of the device, with allowed values from 0 to 15. Count Number of frames captured. Return Value No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error informa- tion.

  • Page 69: Save Image

    HDV62A-FLR In determining whether the input signal is locked, estab- lishes connection of a suitable sensor, from among: 0: No proper signal is detected 1: A proper signal is detected For Analog RGB and YPbPr inputs, Locked = 1 is returned only if the detected sensor format is...

  • Page 70: Audio Stream

    The library supports: BMP: with extension *.bmp JPEG: with extension *.jpg or *.jpeg JIFF: with extension *.tif PNG: with extension *.png Raw data: other file type Return Value No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error informa- tion.

  • Page 71: Other Functions

    HDV62A-FLR void *Data; UINT Size; } AUDIO_STREAM_INFO; public struct AUDIO_STREAM_INFO public IntPtr Data; public uint Size; VB.Net Public Structure AUDIO_STREAM_INFO Public Data As IntPtr Public Size As UInteger End Structure Return Value No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error informa- tion.

  • Page 72: Edid Functions

    GetErrorText (ByVal code As Integer) As String Parameter(s) Code Error code returned by other functions Text Error text string, for containment of which a buffer of maximum 160 bytes must be allocated Return Value C/C++ Always return 0 Return the error text VB.Net Return the error text 2.8 EDID Functions...
  • Page 73 HDV62A-FLR SetEdidReadyStatus (ByVal Number As UInteger, ByVal Status As UInteger) As Integer GetEdidReadyStatus (ByVal Number As UInteger, ByRef Status As UInteger) As Integer Parameter(s) Number The number of the device, with allowed values from 0 to 15. Status Indicates ready status of the EDID ROM, can be read by external device through DVI-I connector, with some external devices capable of resolution auto-adjustment accordingly.

  • Page 74: Access Permission

    HDV62 Ready External Application Device Access Permission Write Protectio n EDID Figure 2-4: EDID ROM Architecture 2.8.2 Access Permission Sets or retrieves application access to the EDID ROM. Syntax C/C++ Hdv62_SetEdidAccessPermission (UINT Num- ber, UINT Status) Hdv62_GetEdidAccessPermission (UINT Num- ber, UINT& Status) int SetEdidAccessPermission (uint Number, uint Status) int GetEdidAccessPermission (uint Number, out...

  • Page 75: Write Protection

    HDV62A-FLR Parameter(s) Number The number of the device, with allowed values from 0 to 15. Status Indicates accessibility of the EDID ROM. Since access can be obtained by application or external device at the same time, to open EDID: Establish access permission...

  • Page 76: Rom Selector

    VB.Net SetEdidWriteProtection (ByVal Number As UInte- ger, ByVal Status As UInteger) As Integer GetEdidWriteProtection (ByVal Number As UInte- ger, ByRef Status As UInteger) As Integer Parameter(s) Number The number of the device, with allowed values from 0 to 15. Status Indicates writeability of the EDID ROM.

  • Page 77: Rom Read/Write

    HDV62A-FLR VB.Net SetEdidRomSelector (ByVal Number As UInteger, ByVal Offset As UInteger) As Integer GetEdidRomSelector (ByVal Number As UInteger, ByRef Offset As UInteger) As Integer Parameter(s) Number The number of the device, with allowed values from 0 to 15. Offset Indicates the offset of the EDID ROM, with allowed values from 0 to 255.

  • Page 78: Audio Format Control Functions

    Other Functions for return code error informa- tion. 2.9 Audio Format Control Functions 2.9.1 Audio Input Sets or retrieves audio input configuration, only one of which is available at one time. Please see the HDV62A User’s Manual for connection details. Syntax C/C++ Hdv62_SetAudioInput (UINT...

  • Page 79: Audio Channels

    HDV62A-FLR Parameter(s) Number The number of the device, with allowed values from 0 to 15. Channel Audio source configuration, from among: 0: HDMI audio 1: SPDIF audio (Toslink) 2: SPDIF audio (RCA) Return Value No error occurs if return value ≥ 0; if a negative value, please refer to Other Functions for return code error informa- tion.

  • Page 80: Samples Per Second

    Parameter(s) Number The number of the device, with allowed values from 0 to 15. Channels Specifies the number of channels of audio data, according Stereo audio: 2 5.1 channel audio: 6 7.1 channel audio: 8 Currently SPDIF audio only supports up to 2 channels. Return Value No error occurs if return value ≥...

  • Page 81: Bits Per Sample

    HDV62A-FLR GetAudioSamplesPerSec (ByVal Number As UInte- ger, ByRef Value As UInteger) As Integer Parameter(s) Number The number of the device, with allowed values from 0 to 15. Value Specifies sample frequency for each channel, such as 48000 when the sample frequency is 48kHz Return Value No error occurs if return value ≥...

  • Page 82: Audio Capabilties

    The number of the device, with allowed values from 0 to 15. Value Specifies the number of bits per sample, which the hard- ware extends to 24 bits if the audio source is 16 or 20 bit input. Return Value No error occurs if return value ≥...
  • Page 83 HDV62A-FLR unsigned long *Channels; unsigned long NumBitsPerSample; unsigned long *BitsPerSamples; unsigned long NumSamplesPerSec; unsigned long *SamplesPerSecs; } AUDIO_FORMATS; typedef struct _AUDIO_CAPABILITIES AUDIO_FORMATS HdmiAudioFormats; AUDIO_FORMATS Spdif1AudioFormats; AUDIO_FORMATS Spdif2AudioFormats; } AUDIO_CAPABILITIES; struct AUDIO_FORMATS public uint NumChannels; public IntPtr Channels; public uint NumBitsPerSample;...
  • Page 84 public AUDIO_FORMATS Spdif2AudioFormats; VB.Net Structure AUDIO_FORMATS Dim NumChannels As UInteger Dim Channels As IntPtr Dim NumBitsPerSample As UInteger Dim BitsPerSamples As IntPtr Dim NumSamplesPerSec As UInteger Dim SamplesPerSecs As IntPtr End Structure Public Structure AUDIO_CAPABILITIES Dim HdmiAudioFormats As AUDIO_FORMATS Dim Spdif1AudioFormats As AUDIO_FORMATS Dim Spdif2AudioFormats As AUDIO_FORMATS End Structure Return Value...

  • Page 85: Important Safety Instructions

    HDV62A Important Safety Instructions For user safety, please read and follow all instructions, WARNINGS, CAUTIONS, and NOTES marked in this manual and on the associated equipment before handling/operating the equipment. Read these safety instructions carefully. Keep this user’s manual for future reference.
  • Page 86 Never attempt to fix the equipment. Equipment should only be serviced by qualified personnel. A Lithium-type battery may be provided for uninterrupted, backup or emergency power. Risk of explosion if battery is replaced with one of an incorrect type. Dispose of used batteries appropriately. WARNING: Equipment must be serviced by authorized technicians when:...

  • Page 87: Getting Service

    5215 Hellyer Avenue, #110, San Jose, CA 95138, USA Tel: +1-408-360-0200 Toll Free: +1-800-966-5200 (USA only) Fax: +1-408-360-0222 Email: info@adlinktech.com ADLINK Technology (China) Co., Ltd. Address: (201203) 300 Fang Chun Rd., Zhangjiang Hi-Tech Park, Pudong New Area, Shanghai, 201203 China Tel: +86-21-5132-8988 Fax:...
  • Page 88 84 Genting Lane #07-02A, Cityneon Design Centre, Singapore 349584 Tel: +65-6844-2261 Fax: +65-6844-2263 Email: singapore@adlinktech.com ADLINK Technology Singapore Pte. Ltd. (Indian Liaison Office) Address: 1st Floor, #50-56 (Between 16th/17th Cross) Margosa Plaza, Margosa Main Road, Malleswaram, Bangalore-560055, India Tel: +91-80-65605817, +91-80-42246107 Fax: +91-80-23464606 Email: india@adlinktech.com...

Table of Contents