+++ /dev/null
-InstDrv.dll version 0.2 - Installs or Removes Device Drivers\r
-------------------------------------------------------------\r
-\r
-\r
-The plugin helps you to create NSIS scripts for installing device drivers or\r
-removing them again. It can count installed device instances, create new ones\r
-or delete all supported device. InstDrv works on Windows 2000 or later.\r
-\r
-\r
-\r
-InstDrv::InitDriverSetup devClass drvHWID\r
-Return: result\r
-\r
-To start processing a driver, first call this function. devClass is the GUID\r
-of the device class the driver supports, drvHWID is the device hardware ID. If\r
-you don't know what these terms mean, you may want to take a look at the\r
-Windows DDK. This function returns an empty string on success, otherwise an\r
-error message.\r
-\r
-InitDriverSetup has to be called every time after the plugin dll has been\r
-(re-)loaded, or if you want to switch to a different driver.\r
-\r
-\r
-\r
-InstDrv::CountDevices\r
-Return: number\r
-\r
-This call returns the number of installed and supported devices of the driver.\r
-\r
-\r
-\r
-InstDrv::CreateDevice\r
-Return: result\r
-\r
-To create a new deviced node which the driver has to support, use this\r
-function. You may even call it multiple times for more than one instance. The\r
-return value is the Windows error code (in hex). Use CreateDevice before\r
-installing or updating the driver itself.\r
-\r
-\r
-\r
-InstDrv::InstallDriver infPath\r
-Return: result\r
- reboot\r
-\r
-InstallDriver installs or updates a device driver as specified in the .inf\r
-setup script. It returns a Windows error code (in hex) and, on success, a flag\r
-signalling if a system reboot is required.\r
-\r
-\r
-\r
-InstDrv::DeleteOemInfFiles\r
-Return: result\r
- oeminf\r
- oempnf\r
-\r
-DeleteOemInfFiles tries to clean up the Windows inf directory by deleting the\r
-oemXX.inf and oemXX.pnf files associated with the drivers. It returns a\r
-Windows error code (in hex) and, on success, the names of the deleted files.\r
-This functions requires that at least one device instance is still present.\r
-So, call it before you remove the devices itself. You should also call it\r
-before updating a driver. This avoids that the inf directory gets slowly\r
-messed up with useless old setup scripts (which does NOT really accelerate\r
-Windows). The error code which comes up when no device is installed is\r
-"00000103".\r
-\r
-\r
-\r
-InstDrv::RemoveAllDevices\r
-Return: result\r
- reboot\r
-\r
-This functions deletes all devices instances the driver supported. It returns\r
-a Windows error code (in hex) and, on success, a flag signalling if the system\r
-needs to be rebooted. You additionally have to remove the driver binaries from\r
-the system paths.\r
-\r
-\r
-\r
-InstDrv::StartSystemService serviceName\r
-Return: result\r
-\r
-Call this function to start the provided system service. The function blocks\r
-until the service is started or the system reported a timeout. The return value\r
-is the Windows error code (in hex).\r
-\r
-\r
-\r
-InstDrv::StopSystemService serviceName\r
-Return: result\r
-\r
-This function tries to stop the provided system service. It blocks until the\r
-service has been shut down or the system reported a timeout. The return value\r
-is the Windows error code (in hex).\r
-\r
-\r
-\r
-Example.nsi\r
-\r
-The example script installs or removes the virtual COM port driver of IrCOMM2k\r
-(2.0.0-alpha8, see www.ircomm2k.de/english). The driver and its setup script\r
-are only included for demonstration purposes, they do not work without the\r
-rest of IrCOMM2k (but they also do not cause any harm).\r
-\r
-\r
-\r
-Building the Source Code\r
-\r
-To build the plugin from the source code, some include files and libraries\r
-which come with the Windows DDK are required.\r
-\r
-\r
-\r
-History\r
-\r
- 0.2 - fixed bug when calling InitDriverSetup the second time\r
- - added StartSystemService and StopSystemService\r
-\r
- 0.1 - first release\r
-\r
-\r
-\r
-License\r
-\r
-Copyright © 2003 Jan Kiszka (Jan.Kiszka@web.de)\r
-\r
-This software is provided 'as-is', without any express or implied\r
-warranty. In no event will the authors be held liable for any damages\r
-arising from the use of this software.\r
-\r
-Permission is granted to anyone to use this software for any purpose,\r
-including commercial applications, and to alter it and redistribute\r
-it freely, subject to the following restrictions:\r
-\r
-1. The origin of this software must not be misrepresented; \r
- you must not claim that you wrote the original software.\r
- If you use this software in a product, an acknowledgment in the\r
- product documentation would be appreciated but is not required.\r
-2. Altered versions must be plainly marked as such,\r
- and must not be misrepresented as being the original software.\r
-3. This notice may not be removed or altered from any distribution.\r
projects / fw / altos / blobdiff