README file for the VS 2019 CPP sample project

Copyright (c) 2020 ARM Research Laboratories

This README file gives an overview of the VS 2019 CPP sample project.

This project links the sample CPP file CPPSample\main.cpp with the
SNFMulti import library.

To build this application:

  1) Open VS2019CPPSampls\VS2019CPPSample.sln with VS 2019.

  2) Select "x64" (if available) or "x86" for the platform.

  3) In the project, open main.cpp.  Verify that the value of
  ConfigurationPath is the path for the snf_enging.xml Sniffer
  configuration file.

  4) Build.

In order to create the SNFMulti import and export libraries, do the
following:

  1) Open a VS2019 command prompt (Tools->Visual Studio 2019 Command
  Prompt).

  2) Change to the 32bitDll directory of the SDK.

  3) Enter the command:

     LIB /MACHINE:x86 /DEF:snfmulti.def /name:snfmulti.dll /out:vs2019_snfmulti.lib

  This creates the vs2019_snfmulti.lib import library and
  vs2019_snfmulti.exp export library for the x86 platform.  To create
  the libraries for the x64 platform:

  4) Change to the 64bitDll directory of the SDK.

  5) Enter the command:

     LIB /MACHINE:x64 /DEF:snfmulti.def /name:snfmulti.dll /out:vs2019_snfmulti.lib

  This creates libraries for the x64 platform.

To modify a solution file to use SNFMulti, do the following:

  1) Add the header file include/snfmultidll.h.

  2) In Project -> Properties -> Debugging -> Environment, add
  the directory containing the SNFMulti libraries and other DLLs.

  3) In Project -> Properties -> Linker -> Input -> Additional
  Dependencies, prepend "vs2019_snfmulti.lib".

  4) In Project -> Properties -> Linker -> Optimization -> Link Time
  Code Generation, specify "Use Link Time Code Generation").
