Syntax

  struct DeviceSpecificInfoDef 
  { 
      LONG   status; 
      OBID   subsystemid; 
      BYTE   targetnumber; 
      BYTE   unitnumber; 
      BYTE   cardnumber; 
      BYTE   accessflags; 
      LONG   devicetype; 
      LONG   blocksize; 
      LONG   unitsize; 
      BYTE   heads; 
      BYTE   sectors; 
      WORD   cylinders; 
      LONG   capacity; 
      OBID   mmadapterid; 
      OBID   mmmediaid; 
      BYTE   rawname[MM_MAX_OBJECT_STRING_LEN]; 
  };
  

Fields

status

This value is identical to the status field in IOObjectGenericInfoDef structure.

subsystemid

The OBID of the IO subsystem that created the specific information.

targetnumber

For SCSI devices, the SCSI ID used to identify the device on the SCSI bus. For IDE devices, this value is 0, 1, 2, or 3 for Primary, Secondary, Tertiary, or Quaternary, respectively. This value follows the ‘ D’ within the bracketed portion of the device’s formal name. See the name field of the IOObjectGenericInfoDef structure. (Typing List Devices on the server console displays devices by their formal names.)

unitnumber

For SCSI devices, the Logical Unit Number (LUN) as defined by SCSI. For IDE devices, this value is 0 for Master and 1 for Slave. This value follows the ":" within the bracketed portion of the device’s formal name. See the name field of theIOObjectGenericInfoDef structure. (Typing List Devices on the server console displays devices by their formal names.)

cardnumber

This field is a relic from past implementations of the Media Manager and has no real value.

accessflags

Bit field describing the following aspects of the device:

Bit	Description
0x01	Object contains removable data.
0x02	Object is read only or write protected.
0x10	Object is a changer.
0x20	Object accepts magazines.

devicetype

This identifies the device type. See Device and Media Types (as defined by the SCSI Specification) for a list of device types.

blocksize

The maximum number of units this device can support in a single IO request. IO requests greater than this value are broken down by the Media Manager into multiple smaller requests to accommodate the block size.

unitsize

The number of bytes per unit. For fixed disks, this value is typically 512. It is variable for most tape devices.

heads

The number of read/write heads in the device. This value does not apply to tape devices.

sectors

The number of sectors per track on the media in the device. This value does not apply to tape devices.

cylinders

The number of cylinders on the media in the device. The number of heads multiplied by the number of sectors per track produces the number of bytes per cylinder. This value does not apply to tape devices.

capacity

The total number of sectors on the media. For tape devices, this value can be an approximation or even undefined.

mmadapterid

The OBID of the adapter to which this device is attached to, i.e., this device’s parent object.

mmmedianumber

The OBID of the media in the device, i.e., the device’s child object.

rawname

Device name as defined by the driver. This name does not have the bracketed information given in the formal name.