HAMInfoStruct
Used by a HAM to supply information about the HAM itself to the Media Manager upon request.
struct HAMInfoStruct { LONG deviceInfoStructureLength; WORD haType; BYTE busNo; BYTE cardNo; LONG novellAssignedModuleID; BYTE name[64]; LONG supportedTargetIDs; LONG supportedUnitNumbers; LONG adapterTargetID; LONG slotOption; LONG flags; LONG reserved[8];};
For SCSI devices, this value is the length of the header (32 bytes) plus the SCSI Inquiry Data (36 bytes). For IDE-ATA devices, this value is the length of the header (32 bytes) plus the IDE-ATA Information (512 bytes).
For custom HAMs (hacbType = 3), this value is the length of the header (32 bytes) plus the size of UpdateInfoStruct (at least 264 bytes).
For vendor-specific CDMs and HAMs, it is the length of the header (32 bytes) plus the length of the vendor-specific Information.
This identifier accommodates those adapters that have more than one bus on which to attach devices.
This number is set by the HAM.
This number is decided by the HAM.
This number is given to a driver vendor from Developer Services and should be hard-coded in the module.
This number is used in registering a module and in hot replacement.
The name is a string where byte 0 contains the string length and bytes 1 through 63 contain the characters that constitute the actual name.
If this parameter is not used or not known, it must be set to -1.
Value |
Description |
Description |
---|---|---|
0x00000001 |
Instance_Unload_Supported |
|
0x00000002 |
Hardware_Hot_Pluggable |
|
0x00000004 |
Reserved |
|
0x00000008 |
Interrupt_Safe_Execute |
If the HAM_Execute_HACB function has interrupts disabled at their critical paths, this bit can be set, which could provide performance improvement. Setting this bit is mandatory for MP-enabled HAMs. If this bit is not set, interrupts are disabled by NWPA during the HAM_Execute_HACB function. |
0x00000010 |
Real_Mode_Not_Supported |
When set, this bit informs NWPA that the driver does not support transitions to Real Mode. Because the operating system switches to Real Mode when it attempts to unload the driver, setting this bit also prevents the driver from being unloaded. |
0x00000020 |
Slot_Not_Registered |
When set, this bit informs NWPA that the driver uses slot 0 as its HIN or does not register a slot value. |
The HAM needs to maintain an instance of this structure for each bus it supports.