InitCVIRTE

int InitCVIRTE (void *HInstance, char * argv[], void *reserved);

Purpose

Performs initialization of the LabWindows/CVI Run-Time Engine. You need InitCVIRTE only in executables or DLLs that you link using an external compilerexternal compiler. Otherwise, the function is harmless.

(Linux) You must call InitCVIRTE to initialize the libraries from the executable.

Call InitCVIRTE in your main, WinMain, or DllMain function. Which of these three functions you use determines the parameter values you pass to InitCVIRTE. The following examples show how to use InitCVIRTE in each case:

int main (int argc, char *argv[])
{

if (InitCVIRTE (0, argv, 0) == 0)

return -1; /* out of memory */

/* your other code */
return 0;

}

  int __stdcall WinMain (HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpszCmdLine, int nCmdShow)

{

if (InitCVIRTE (hInstance, 0, 0) == 0)

return -1; /* out of memory */

/* your other code */
return 0;

}

  int __stdcall DllMain (void *hinstDLL, int fdwReason, void *lpvReserved)

{

if (fdwReason == DLL_PROCESS_ATTACH)

{
if (InitCVIRTE (hinstDLL, 0, 0) == 0)

return 0; /* out of memory */
/* your other ATTACH code */
}

else if (fdwReason == DLL_PROCESS_DETACH)

{
/* your other DETACH code */
CloseCVIRTE ();
}

return 1;

}

Note The prototypes for InitCVIRTE and CloseCVIRTE are in cvirte.h, which is included by utility.h. In LabWindows/CVI 4.0.1, the number of parameters to this function increased from one to three. Executables and DLLs created using just one parameter will continue to work.

Parameters

Return Value

Additional Information

Library: Utility Library

Include file: utility.h

LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later