SCSI Information DLL

Purpose

SCSI Info DLL helps to identify SCSI parmeters of local
SCSI drives by their drive letters and determine drive letter by SCSI parameters
on Windows NT machines.

Usage

SCSIInfo.DLL exports following functions:

• BOOL ScanDrives(void)    
  – scans local drives and stores internally their SCSI parameters

    return: ERROR_SUCCESS if
succeeded, OS error code if failed
    remarks: this function has to be called before any
other request can be issued. in case of changes in SCSI configuration call 
    this
function again to refresh internal information

• int GetDriveInfo(char cDriveLetter,int* pPortNumber,int*
  pPathId,int* pTargetId,int* pLun)
  – returns SCSI parameters for specified drive letter:
  • cDriveLetter – drive letter
  • pPortNumber – pointer to variable receiving
    port number or NULL
  • pPathId– pointer to variable receiving port
    id or NULL
  • pTargetId – pointer to variable receiving
    target id or NULL
  • pLun – pointer to variable receiving LUN or
    NULL

    return: ERROR_SUCCESS if
succeeded, ERROR_FILE_NOT_FOUND if no information found
    remarks: before first call of this function the
function ScanDrives() should be called at least once. if one or more pointers to 
    receiving  variables are NULL,  the variable value assumed as not
required and will not be filled (e.g. if only PortNumber is 
    required, set pPortNumber to address of receiving  variable and let
other parameters to be NULL)

• int GetDriveLetter(char* pcDriveLetter,int PortNumber,int PathId,int TargetId,int
  Lun)
  – returns drive letter for specified SCSI parameters:
  • pcDriveLetter – pointer to variable receiving drive
    letter, cannot be NULL
  • PortNumber – port number
  • PathId – path id
  • TargetId – target id
  • Lun – LUN

    return: ERROR_SUCCESS if succeeded,
ERROR_FILE_NOT_FOUND if no information found
    remarks: before first call of this function the function

ScanDrives() should be called at least once.

• int GetDriveNumber(int PortNumber,int PathId,int TargetId,int
  Lun)
  – returns drive number (0 – A, 1 – B, 3 – C etc.)  for specified SCSI parameters:
  • PortNumber – port number
  • PathId – path id
  • TargetId – target id
  • Lun – LUN

      return: zero based drive number,
  -1 no information found
      remarks: before first call of this function the function
  
  ScanDrives() should be called at least once.

   

Support

For bugfixes and future releases mailto:m.becker@ais-gmbh.de

Copyright Information

Copyright A.I.S. GmbH (C) 2000

Version Information

Downloads

Download source code and demo project (including release build of demo app) – 142 Kb