Benutzerhandbuch für National Instruments Drums 320685D-01

Inhaltsverzeichnis

• LabWindows/CVI Programmer Reference Manual

  1
• Support

  2
  • Internet Support

    2
  • Bulletin Board Support

    2
  • Fax-on-Demand Support

    2
  • Telephone Support (USA)

    2
  • International Offices

    2
  • National Instruments Corporate Headquarters

    2
• Important Information

  3
  • Warranty

    3
  • Copyright

    3
  • Trademarks

    3
  • WARNING REGARDING MEDICAL AND CLINICAL USE OF NATI...

    3
• Contents

  4
• About This Manual

  12
  • Organization of This Manual

    12
  • Conventions Used in This Manual

    13
    • Related Documentation

      14
    • Customer Communication

      15
• Chapter 1 LabWindows/CVI Compiler

  16
  • Overview

    16
  • LabWindows/CVI Compiler Specifics

    16
    • Compiler Limits

      16
    • Compiler Options

      17
    • Compiler Defines

      17
  • C Language Non-Conformance

    17
  • C Language Extensions

    17
    • Keywords That Are Not ANSI C Standard

      17
    • Calling Conventions (Windows 95/NT Only)

      17
    • Import and Export Qualifiers

      18
    • C++ Comment Markers

      19
    • Duplicate Typedefs

      19
    • Structure Packing Pragma (Windows 3.1 and Windows ...

      19
    • Program Entry Points (Windows 95/NT Only)

      20
  • C Library Issues

    20
    • Using the Low-Level I/O Functions

      20
  • C Data Types and 32-Bit Compiler Issues

    21
    • Data Types

      21
    • Converting 16-Bit Source Code to 32-Bit Source Cod...

      21
  • Debugging Levels

    23
  • User Protection

    23
    • Array Indexing and Pointer Protection Errors

      23
      • Pointer Arithmetic (Non-Fatal)

        23
      • Pointer Assignment (Non-Fatal)

        24
      • Pointer Dereference Errors (Fatal)

        24
      • Pointer Comparison (Non-Fatal)

        25
      • Pointer Subtraction (Non-Fatal)

        25
      • Pointer Casting (Non-Fatal)

        25
    • Dynamic Memory Protection Errors

      26
      • Memory Deallocation (Non-Fatal)

        26
      • Memory Corruption (Fatal)

        26
    • General Protection Errors

      26
    • Library Protection Errors

      26
    • Disabling User Protection

      27
      • Disabling Protection Errors at Run-Time

        27
      • Disabling Library Errors at Run-Time

        27
      • Disabling Protection for Individual Pointer

        27
      • Disabling Library Protection Errors for Functions

        28
    • Details of User Protection

      29
      • Pointer Casting

        29
      • Dynamic Memory

        30
      • Library Functions

        31
      • Unions

        31
  • Stack Size

    31
  • Include Paths

    32
    • Include Path Search Precedence

      32
• Chapter 2 Using Loadable Compiled Modules

  33
  • About Loadable Compiled Modules

    33
    • Advantages and Disadvantages of Using Loadable Com...

      34
    • Using a Loadable Compiled Module as an Instrument ...

      34
    • Using a Loadable Compiled Module as a User Library...

      35
    • Using a Loadable Compiled Module in the Project Li...

      35
    • Using a Loadable Compiled Module as an External Mo...

      36
    • Notification of Changes in Run State

      36
      • Example 1

        37
      • Example 2

        38
    • Using Run State Change Callbacks in a DLL

      38
    • Compiled Modules that Contain Asynchronous Callbac...

      39
• Chapter 3 Windows 95/NT Compiler/Linker Issues

  40
  • Loading 32-Bit DLLs under Windows95/NT

    40
    • DLLs for Instrument Drivers and User Libraries

      41
    • Using The LoadExternalModule Function

      41
    • Link Errors when Using DLL Import Libraries

      41
    • DLL Path (.pth) Files Not Supported

      41
    • 16-Bit DLLs Not Supported

      41
    • Run State Change Callbacks in DLLs

      41
    • DllMain

      42
    • Releasing Resources when a DLL Unloads

      42
    • Generating an Import Library

      43
    • Default Unloading/Reloading Policy

      43
  • Compatibility with External Compilers

    43
    • Choosing Your Compatible Compiler

      44
    • Object Files, Library Files, and DLL Import Librar...

      44
    • Compatibility Issues in DLLs

      44
      • Structure Packing

        45
      • Bit Fields

        45
      • Returning Floats and Doubles

        46
      • Returning Structures

        46
      • Enum Sizes

        46
      • Long Doubles

        46
    • Differences between LabWindows/CVI and the Externa...

      46
    • External Compiler Versions Supported

      47
    • Required Preprocessor Definitions

      47
  • Multithreading and the LabWindows/CVI Libraries

    47
  • Using LabWindows/CVI Libraries in External Compile...

    48
    • Include Files for the ANSI C Library and the LabWi...

      49
    • Standard Input/Output Window

      49
    • Resolving Callback References from .UIR Files

      49
      • Linking to Callback Functions Not Exported from a ...

        50
    • Resolving References from Modules Loaded at Run-Ti...

      51
      • Resolving References to the LabWindows/CVI Run-Tim...

        51
      • Resolving References to Symbols Not in Run-Time En...

        51
      • Resolving Run-Time Module References to Symbols No...

        52
    • Run State Change Callbacks Are Not Available in Ex...

      52
    • Calling InitCVIRTE and CloseCVIRTE

      53
    • Watcom Stack Based Calling Convention

      54
  • Using Object and Library Files in External Compile...

    54
    • Default Library Directives

      54
      • Microsoft Visual C/C++

        55
      • Borland C/C++

        55
      • Watcom C/C++

        55
      • Symantec C/C++

        55
    • Borland Static versus Dynamic C Libraries

      56
    • Borland Incremental Linker

      56
    • Borland C++ Builder

      56
    • Watcom Pull-in References

      56
  • Creating Object and Library Files in External Comp...

    57
    • Microsoft Visual C/C++

      57
    • Borland C/C++

      57
    • Watcom C/C++

      58
    • Symantec C/C++

      58
  • Creating Executables in LabWindows/CVI

    59
  • Creating DLLs in LabWindows/CVI

    59
    • Customizing an Import Library

      59
    • Preparing Source Code for Use in a DLL

      60
      • Calling Convention for Exported Functions

        60
      • Exporting DLL Functions and Variables

        61
      • Include File Method

        61
      • Export Qualifier Method

        61
      • Marking Imported Symbols in Include File Distribut...

        62
      • Recommendations

        63
    • Automatic Inclusion of Type Library Resource for V...

      63
  • Creating Static Libraries in LabWindows/CVI

    64
  • Creating Object Files in LabWindows/CVI

    65
  • Calling Windows SDK Functions in LabWindows/CVI

    65
    • Windows SDK Include Files

      65
    • Using Windows SDK Functions for User Interface Cap...

      66
    • Using Windows SDK Functions to Create Multiple Thr...

      66
    • Automatic Loading of SDK Import Libraries

      66
  • Setting Up Include Paths for LabWindows/CVI, ANSI ...

    67
    • Compiling in LabWindows/CVI for Linking in LabWind...

      67
    • Compiling in LabWindows/CVI for Linking in an Exte...

      67
    • Compiling in an External Compiler for Linking in a...

      67
    • Compiling in an External Compiler for Linking in L...

      68
  • Handling Hardware Interrupts under Windows95/NT

    68
• Chapter 4 Windows 3.1 Compiler/Linker Issues

  69
  • Using Modules Compiled by LabWindows/CVI

    69
  • Using 32-Bit Watcom Compiled Modules underWindows...

    69
  • Using 32-Bit Borland or Symantec Compiled Modules ...

    70
  • 16-Bit Windows DLLs

    71
    • Helpful LabWindows/CVI Options for Working with DL...

      72
    • DLL Rules and Restrictions

      72
    • DLL Glue Code

      75
      • DLLs That Can Use Glue Code Generated at Load Time...

        76
      • DLLs That Cannot Use Glue Code Generated at Load T...

        76
      • Loading a DLL That Cannot Use Glue Code Generated ...

        76
    • Recognizing Windows Messages Passed from a DLL

      89
    • Creating 16-bit DLLs with Microsoft Visual C++ 1.5...

      89
    • Creating 16-bit DLLs with Borland C++

      90
    • DLL Search Precedence

      91
• Chapter 5 UNIX Compiler/Linker Issues

  93
  • Calling Sun C Library Functions

    93
    • Restrictions on Calling Sun C Library Functions

      93
  • Using Shared Libraries in LabWindows/CVI

    94
    • Using dlopen

      94
  • The LabWindows/CVI Run-Time Engine as a Shared Lib...

    94
  • Creating Executables that Use the LabWindows/CVI L...

    95
    • Compatible External Compilers

      95
    • Static and Shared Versions of the ANSI C and Other...

      95
    • Non-ANSI Behavior of Sun Solaris 1 ANSI C Library

      96
    • LabWindows/CVI Implements printf and scanf

      96
    • Main Function Must Call InitCVIRTE

      96
    • Run State Change Callbacks Are Not Available in Ex...

      97
  • Using Externally Compiled Modules

    98
    • Restrictions on Externally Compiled Modules

      98
    • Compiling Modules With External Compilers

      98
  • Locking Process Segments into Memory Using plock()...

    99
  • UNIX Asynchronous Signal Handling

    99
  • Solaris 1 ANSI C Library Implementation

    100
    • Replacement Functions

      101
    • Additional Functions Not Found in Sun Solaris 1 li...

      101
  • Incompatibilities among LabWindows/CVI, Sun Solari...

    102
    • Between LabWindows/CVI and ANSI C

      102
    • Between LabWindows/CVI and Sun Solaris

      103
• Chapter 6 Building Multiplatform Applications

  104
  • Multiplatform Programming Guidelines

    104
    • Library Issues

      104
    • Externally Compiled Modules

      106
  • Multiplatform User Interface Guidelines

    106
• Chapter 7 Creating and Distributing Standalone Executables a...

  107
  • Introduction to the Run-Time Engine

    107
    • Distributing Standalone Executables under Windows

      107
      • Minimum System Requirements for Windows 95/NT

        107
      • No Math Coprocessor Required for Windows 95/NT

        108
      • Minimum System Requirements for Windows 3.1

        108
      • Math Coprocessor Software Emulation for Windows 3....

        108
    • Distributing Standalone Executables under UNIX

      108
      • Distributing Standalone Executables under Solaris ...

        109
      • Distributing Standalone Executables under Solaris ...

        110
      • Minimum System Requirements for UNIX

        111
    • Translating the Message File

      111
  • Configuring the Run-Time Engine

    111
    • Solaris 1 Patches Required for Running Standalone ...

      111
    • Configuration Option Descriptions

      112
      • cvirtx (Windows 3.1 Only)

        112
      • cvidir (Windows Only)

        113
      • useDefaultTimer (Windows Only)

        113
      • DSTRules

        113
      • UNIX Options

        113
  • Necessary Files for Running Executable Programs

    114
  • Necessary Files for Using DLLs Created inWindows...

    115
  • Location of Files on the Target Machine for Runnin...

    115
    • LabWindows/CVI Run-Time Engine under Windows 95/NT...

      116
      • Run-Time Library DLLs

        116
      • Low-Level Support Driver

        116
      • Message, Resource, and Font Files

        117
      • National Instruments Hardware I/O Libraries

        117
    • LabWindows/CVI Run-Time Engine under Windows 3.1

      117
    • LabWindows/CVI Run-Time Engine under Sun Solaris

      118
    • Rules for Accessing UIR, Image, and Panel State Fi...

      118
    • Rules for Using DLL Files under Windows 95/NT

      119
    • Rules for Using DLL Files under Windows 3.1

      119
    • Rules for Loading Files Using LoadExternalModule

      120
      • Forcing Modules that External Modules Refer to int...

        121
      • Using LoadExternalModule on Files in the Project

        121
      • Using LoadExternalModule on Library and Object Fil...

        122
      • Using LoadExternalModule on DLL Files under Window...

        123
      • Using LoadExternalModule on DLL and Path Files und...

        123
      • Using LoadExternalModule on Source Files (.c)

        124
    • Rules for Accessing Other Files

      125
    • Error Checking in Your Standalone Executable or DL...

      125
• Chapter 8 Distributing Libraries and Function Panels

  126
  • How to Distribute Libraries

    126
  • Adding Libraries to User’s Library Menu

    126
  • Specifying Library Dependencies

    127
• Chapter 9 Checking for Errors in LabWindows/CVI

  129
  • Error Checking

    130
  • Status Reporting by LabWindows/CVI Libraries andI...

    131
    • User Interface Library

      131
    • Analysis/Advanced Analysis Libraries

      131
    • Easy I/O for DAQ Library

      132
    • Data Acquisition Library

      132
    • VXI Library

      132
    • GPIB/GPIB 488.2 Library

      132
    • RS-232 Library

      133
    • VISA Library

      133
    • IVI Library

      133
    • TCP Library

      134
    • DDE Library

      134
    • ActiveX Automation Library

      134
    • X Property Library

      134
    • Formatting and I/O Library

      134
    • Utility Library

      135
    • ANSI C Library

      135
    • LabWindows/CVI Instrument Drivers

      135
• Appendix A Errors and Warnings

  136
• Appendix B Customer Communication

  182
  • Electronic Services

    182
  • Telephone and Fax Support

    183
  • Technical Support Form

    184
  • LabWindows/CVI Hardware and Software Configuration...

    185
    • National Instruments Products

      185
    • Other Products

      185
  • Documentation Comment Form

    186
• Glossary

  187
  • A

    187
  • B

    187
  • C

    188
  • D

    188
  • E

    188
  • F

    189
  • G

    189
  • H

    189
  • I

    190
  • L

    191
  • M

    191
  • O

    191
  • P

    191
  • R

    192
  • S

    192
  • T

    193
  • U

    193
  • V

    193
  • W

    194
• Index

  195
  • Special Characters/Numbers

    195
  • A

    195
  • B

    196
  • C

    196
  • D

    197
  • E

    198
  • F

    199
  • G

    199
  • H

    199
  • I

    199
  • K

    200
  • L

    200
  • M

    202
  • N

    202
  • O

    202
  • P

    203
  • Q

    203
  • R

    203
  • S

    204
  • T

    206
  • U

    206
  • V

    208
  • W

    208
  • X

    211
• Figures

  11
  • Figure 71. Files Necessary to Run a LabWindows/CV...

    114
• Tables

  11
  • Table 11. LabWindows/CVI Compiler Limits

    16
  • Table 12. LabWindows/CVI Allowable Data Types

    21
  • Table 13. Stack Size Ranges for LabWindows/CVI

    31
  • Table 71. LabWindows/CVI Run-Time Engine Files

    116
  • Table 72. Windows NT Registry Entry Values for th...

    117
  • Table 73. Pathnames and Targets of Links

    118
  • Table A1. Error Messages (Continued)

    136