旼컴컴컴컴컴컴커
� pDeviceTable 쳐컴DEVICETABLE
읕컴컴컴컴컴컴켸
旼컴컴컴컴컴컴컴컴�
旼컴� pAdapter[0] �
� 쳐컴컴컴컴컴컴컴컴�
넬컴� pAdapter[1] �
납 쳐컴컴컴컴컴컴컴컴�
납 � . . . �
납 쳐컴컴컴컴컴컴컴컴�
납旼� pAdapter[N] �
납� 쳐컴컴컴컴컴컴컴컴� 旼컴컴컴컴컴�
읖�� ADAPTERINFO 0 쳐컴캑 ADAPTER 0 첼 旼컴컴컴커
납 쳐컴컴컴컴컴컴컴컴� 읕컴컴컴컴컴矛캑 UNIT 0 �
납 � UNITINFO[0] � � 읕컴컴컴켸
납 � UNITINFO[1] � � . . .
납 � . . . � � 旼컴컴컴커
납 � UNITINFO[N] � 읕� UNIT N �
납 쳐컴컴컴컴컴컴컴컴� 읕컴컴컴켸
납 쳐컴컴컴컴컴컴컴컴�
납 쳐컴컴컴컴컴컴컴컴� 旼컴컴컴컴컴�
읖� ADAPTERINFO 1 쳐컴캑 ADAPTER 1 첼 旼컴컴컴커
� 쳐컴컴컴컴컴컴컴컴� 읕컴컴컴컴컴矛캑 UNIT 0 �
� � UNITINFO[0] � � 읕컴컴컴켸
� � UNITINFO[1] � � . . .
� � . . . � � 旼컴컴컴커
� � UNITINFO[N] � 읕� UNIT N �
� 쳐컴컴컴컴컴컴컴컴� 읕컴컴컴켸
� 쳐컴컴컴컴컴컴컴컴�
� 쳐컴컴컴컴컴컴컴컴� 旼컴컴컴컴컴�
�� ADAPTERINFO N 쳐컴캑 ADAPTER N 첼 旼컴컴컴커
쳐컴컴컴컴컴컴컴컴� 읕컴컴컴컴컴矛캑 UNIT 0 �
� UNITINFO[0] � � 읕컴컴컴켸
� UNITINFO[1] � � . . .
� . . . � � 旼컴컴컴커
� UNITINFO[N] � 읕� UNIT N �
읕컴컴컴컴컴컴컴컴� 읕컴컴컴켸
IORB_CONFIGURATION
旼컴컴컴컴컴컴컴컴쩡컴컴컴컴컴컴컴컴쩡컴컴컴컴쩡컴컴컴컴컴컴컴컴� 쿑ield Name 쿎 Type 쿗ength 쿏escription � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿶orbh 쿔ORBH 쿏B(68) 쿔ORB header � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿾DeviceTable 쿑AR *PDEVICETABLE쿏D 쿏evice table � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿏eviceTableLen 쿢SHORT 쿏W 쿗ength of table � 읕컴컴컴컴컴컴컴컴좔컴컴컴컴컴컴컴컴좔컴컴컴컴좔컴컴컴컴컴컴컴컴�
On entry to the driver:
iorbh
See IORB General Format.
pDeviceTable
contains a far pointer to a block of storage (length = DeviceTableLen),
allocated by the caller, for the driver to return the DEVICETABLE.
DeviceTableLen
contains the length of the block of storage, in bytes, for the driver to
return the DEVICETABLE (pDeviceTable).
DEVICETABLE
旼컴컴컴컴컴컴컴컴쩡컴컴컴컴컴컴컴컴쩡컴컴컴컴쩡컴컴컴컴컴컴컴컴� 쿑ield Name 쿎 Type 쿗ength 쿏escription � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿌DDLevelMajor 쿢CHAR 쿏B 쿌DD major level � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿌DDLevelMinor 쿢CHAR 쿏B 쿌DD minor level � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿌DDHandle 쿢SHORT 쿏W 쿌DD index � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿟otalAdapters 쿢SHORT 쿏W 쿙umber of � � � � 쿪dapters � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿾Adapter[N] 쿙PADAPTERINFO 쿏W(N) 쿌dapterInfo � � � � 쿾ointers � 읕컴컴컴컴컴컴컴컴좔컴컴컴컴컴컴컴컴좔컴컴컴컴좔컴컴컴컴컴컴컴컴�
On exit from the driver:
ADDLevelMajor/ADDLevelMinor
defines the level of support the adapter device driver is written to. A
driver written to this specification (IBM 0S/2 2.0 Support Level), should
set the fields as follows:
旼컴컴컴컴컴컴컴컴컴컴컴컫컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿑ield Name 쿣alue � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌DD_Level_Major 쿌DD_LEVEL_MAJOR � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌DD_Level_Minor 쿌DD_LEVEL_MINOR � 읕컴컴컴컴컴컴컴컴컴컴컴컨컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴�
ADDHandle
contains the adapter device driver's index returned by the RegisterDeviceClass
DevHlp.
TotalAdapters
defines the number of adapters the device driver supports.
pAdapter[N]
contains an array of near ADAPTERINFO pointers. The number of elements
in the array is determined by the TotalAdapters field.
AdapterInfo
旼컴컴컴컴컴컴컴컴컴컫컴컴컴컴컴컴컴쩡컴컴컴컴쩡컴컴컴컴컴컴컴컴� 쿑ield Name 쿎 Type 쿗ength 쿏escription � 쳐컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿌dapterName[17] 쿢CHAR 쿏B(17) 쿌SCIIZ name � 쳐컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿝eserved 쿢CHAR 쿏B 쿝eserved. Must � � � � 쿫e 0. � 쳐컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿌dapterUnits 쿢SHORT 쿏W 쿙umber of units � 쳐컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿌dapterDevBus 쿢SHORT 쿏W 쿏evice bus types � 쳐컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿌dapterIOAccess 쿢CHAR 쿏B 쿓ost I/O type � 쳐컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿌dapterHostBus 쿢CHAR 쿏B 쿓ost bus type � 쳐컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿌dapterSCSITargetID 쿢CHAR 쿏B 쿟arget ID � 쳐컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿌dapterSCSILUN 쿢CHAR 쿏B 쿗ogical unit � � � � 쿻umber � 쳐컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿌dapterFlags 쿢SHORT 쿏W 쿑lags � 쳐컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿘axHWSGList 쿢SHORT 쿏W 쿘ax HW s/g � � � � 쿮lements � 쳐컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿘axCDBTransferLength쿢LONG 쿏D 쿘ax CDB data � � � � 퀃ransfer length � 쳐컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴탠컴컴컴컴탠컴컴컴컴컴컴컴컴� 쿢nitInfo[N] 쿢NITINFO 쿏D(N) 쿢nit information � 읕컴컴컴컴컴컴컴컴컴컨컴컴컴컴컴컴컴좔컴컴컴컴좔컴컴컴컴컴컴컴컴�
On exit from the driver:
AdapterName[17]
contains the ASCIIZ name string of the adapter. This name is used by the
caller for diagnostic purposes.
Reserved
contains a 0. This is a 16-bit alignment byte.
AdapterUnits
contains the number of units supported by this adapter.
AdapterDevBus
defines the adapter-to-device bus protocol used, as shown in the following
table.
旼컴컴컴컴컴컴컴컴컴컴컴컫컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿛rotocol 쿏escription � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_DEVBUS_ST506 쿏ASD - ST506 CAM-I � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_DEVBUS_ST506_II 쿏ASD - ST506 CAM-II � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_DEVBUS_ESDI 쿏ASD -ESDI � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_DEVBUS_FLOPPY 쿏ASD - Diskette � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_DEVBUS_SCSI_1 쿞CSI - Version-I � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_DEVBUS_SCSI_2 쿞CSI -Version-II � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_DEVBUS_SCSI_3 쿞CSI - Version-III � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_DEVBUS_OTHER 쿛rotocol not listed. � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_DEVBUS_NONSCSI_CDROM 쿻on-SCSI CD-ROM interface � 읕컴컴컴컴컴컴컴컴컴컴컴컨컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴�
One protocol should be elected. The AdapterDevBus protocol values can be OR'd with one or more modifier bits as listed in the following table.
旼컴컴컴컴컴컴컴컴컴컴컴컫컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿘odifier 쿏escription � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_DEVBUS_FAST_SCSI 쿑ast SCSI bus timings � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_DEVBUS_8BIT �8-bit bus width � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_DEVBUS_16BIT �16-bit bus width � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_DEVBUS_32BIT �32-bit bus width � 읕컴컴컴컴컴컴컴컴컴컴컴컨컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴�
AdapterIOAccess
defines the adapter-to-host I/O data transfer capabilities, as shown in
the following table.
旼컴컴컴컴컴컴컴컴컴컴컴컫컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿑lag 쿏escription � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_IOACCESS_BUS_MASTER �1st-party DMA adapter � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_IOACCESS_PIO 쿛rogrammed INs/OUTs � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_IOACCESS_DMA_SLAVE �2nd-party DMA adapter � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_IOACCESS_MEMORY_MAP 쿘emory-mapped I/O � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_IOACCESS_OTHER 쿔/O access not listed. � 읕컴컴컴컴컴컴컴컴컴컴컴컨컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴�
AdapterHostBus
defines the adapter-to-host bus type used, as shown in the following table.
旼컴컴컴컴컴컴컴컴컴컴컴컫컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿟ype 쿏evice Connection � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_HOSTBUS_ISA 쿔SA � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_HOSTBUS_EISA 쿐xtended ISA � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_HOSTBUS_uCHNL 쿘icro-channel � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_HOSTBUS_OTHER 쿍us type not listed. � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_HOSTBUS_UNKNOWN 쿍us type unknown. � 읕컴컴컴컴컴컴컴컴컴컴컴컨컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴�
旼컴컴컴컴컴컴컴컴컴컴컴컫컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿥idth 쿏escription � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_HOSTBUS_8BIT �8-bit bus � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_HOSTBUS_16BIT �16-bit bus � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_HOSTBUS_32BIT �32-bit bus � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_HOSTBUS_64BIT �64-bit bus � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌I_HOSTBUS_UNKNOWN 쿍us width unknown. � 읕컴컴컴컴컴컴컴컴컴컴컴컨컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴�
Note: One bus type should be set with one bus width OR'd in.
AdapterSCSITargetID
contains the target ID for the SCSI adapter. For non-SCSI devices, this
field should be set to 0.
AdapterSCSILUN
contains the logical unit number for the SCSI adapter. For non-SCSI devices,
this field should be set to 0.
AdapterFlags
defines the adapter's characteristics, as shown in the following table.
旼컴컴컴컴컴컴컴컴컴컴컴컫컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿑lag 쿏escription � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌F_16M �>16M addresses supported. If set, � � 퀃his flag indicates that the adapter� � 퀂upports >16M addresses. � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌F_IBM_SCB 쿔BM SCB support. If set, this flag � � 쿶ndicates that the adapter supports � � 쿔BM SCB-formatted � � 쿔OCC_ADAPTER_PASSTHRU requests. � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌F_HW_SCATGAT 쿓ardware scatter/gather. If set, � � 퀃his flag indicates that hardware � � 퀂upports scatter/gather. If this � � 쿯lag is not set, it indicates that � � 퀃he device driver is emulating the � � 퀂/g function in software. � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌F_CHS_ADDRESSING 쿔/O addressing. If set, this flag � � 쿶ndicates that the adapter supports � � 쿬ylinder/head/sector addressing. � � 쿟his flag should be set only for � � 쿭iskette controllers. � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿌F_ASSOCIATED_DEVBUS 쿘ultiple bus adapter. If set, this � � 쿯lag indicates that the adapter � � 퀂upports more than one device bus. � � 쿌n ADAPTERINFO and UNITINFO � � 퀂tructure(s) should be created to � � 쿭escribe each device bus. This flag � � 쿺ust be set in each ADAPTERINFO � � 퀂tructure for the adapter, except � � 퀃he first. � 읕컴컴컴컴컴컴컴컴컴컴컴컨컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴�
MaxHWSGList
contains the maximum number of elements supported in a single hardware scatter/gather
list. This field should be set to 0 if the adapter hardware supports an
unlimited s/g list length.
Note: This is not a limit on the number of s/g elements an adapter device driver can receive in a scatter/gather list for an Execute_IO IORB.
See Adapter Device Driver Interface Questions and Answers for more information.
MaxCDBTransferLength
contains the maximum number of bytes supported by this adapter on a CDB-data
transfer request.
This field is set in cases where a device driver needs to emulate s/g support in software and requires a fixed-size buffer to do so. This field should be set to 0 if an driver does not need to emulate its s/g function using an in-memory buffer.
See Adapter Device Driver Interface Questions and Answers for more information.
UnitInfo[N]
contains an array of UNITINFO structures as shown in the following table.
The number of elements in the array is determined by the AdapterUnits
field.
UNITINFO Structure
旼컴컴컴컴컴컴컴컴쩡컴컴컴컴컫컴컴컴컴컫컴컴컴컴컴컴컴컴컴컴컴컴� 쿐lement 쿎 Type 쿗ength 쿏escription � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컵컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴� �AdapterIndex 쿢SHORT 쿏W 쿌ssociated AdapterIndex � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컵컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴� 쿢nitIndex 쿢SHORT 쿏W 쿢nit tag � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컵컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴� 쿢nitFlags 쿢SHORT 쿏W 쿢nit flags � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컵컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴� 쿝eserved 쿢SHORT 쿏W 쿝eserved. Must be 0. � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컵컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴� 쿢nitHandle 쿢SHORT 쿏W 쿌ssigned by adapter � � � � 쿭evice driver � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컵컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴� 쿑ilterADDHandle 쿢SHORT 쿏W 쿑ilter device driver � � � � 쿴andle � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컵컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴� 쿢nitType 쿢SHORT 쿏W 쿢nit type � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컵컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴� 쿜ueuingCount 쿢SHORT 쿏W 쿔ORB queue length � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컵컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴� 쿢nitSCSITargetID 쿢CHAR 쿏B 쿞CSI target ID � 쳐컴컴컴컴컴컴컴컴탠컴컴컴컴컵컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴� 쿢nitSCSILUN 쿢CHAR 쿏B 쿞CSI logical unit number� 읕컴컴컴컴컴컴컴컴좔컴컴컴컴컨컴컴컴컴컨컴컴컴컴컴컴컴컴컴컴컴컴�
On exit from the driver:
AdapterIndex
contains the unit's corresponding adapter's index in the pAdapter[N]
array.
UnitIndex
contains the unit's index in the UnitInfo[N] array.
UnitFlags
defines the unit's characteristics, as shown in the following table.
旼컴컴컴컴컴컴컴컴컴컴컴컫컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿑lag 쿏escription � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢F_REMOVABLE 쿘edia can be removed. If set, this � � 쿯lag indicates that the unit's media� � 쿶s removable. � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢F_CHANGELINE 쿎hangeline supported. If set, this � � 쿯lag indicates that the unit can � � 쿭etect media removal. � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢F_PREFETCH 쿝ead Prefetch supported. If set, � � 퀃his flag indicates the unit � � 퀂upports read prefetch. � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢F_A_DRIVE 쿘anages drive A. If set, this flag � � 쿶ndicates that the unit manages � � 쿭rive A. � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢F_B_DRIVE 쿘anages drive B. If set, this flag � � 쿶ndicates that the unit manages � � 쿭rive B. � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢F_NODASD_SUPT 쿞uppress DASD device manager. If � � 퀂et, this flag indicates that the � � 쿭river does not want this unit to be� � 쿺anaged by the OS2DASD.DMD device � � 쿺anager. � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢F_NOSCSI_SUPT 쿞uppress SCSI device manager. If � � 퀂et, this flag indicates that the � � 쿭river does not want this unit to be� � 쿺anaged by the OS2SCSI.DMD device � � 쿺anager. � 쳐컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢F_DEFECTIVE 쿏evice is defective. If set, this � � 쿯lag indicates that the unit is not � � 쿽perational. Defective units are � � 쿶gnored by the DASD and SCSI device � � 쿺anagers. However, the driver � � 퀂hould accept allocation requests � � 쿯or the unit and pass commands to � � 퀃he unit for other device managers. � � 쿟he information returned by the � � 쿔OCM_UNIT_STATUS command reflects � � 퀃his flag's current setting. � 읕컴컴컴컴컴컴컴컴컴컴컴컨컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴�
Reserved
is reserved for future growth. Must be set to 0 by the adapter device driver.
UnitHandle
defines the unit's handle. This handle is a unique ID, assigned by either
the filter device driver or the adapter device driver. A unit is fully identified
by the UnitHandle field and its associated ADD's handle, defined
by either the FilterADDHandle or ADDHandle fields.
FilterADDHandle
contains the handle of the filter device driver. If a filter device driver
does not exist, this field must be 0. See Using
Filter Device Drivers for more information on filter device drivers.
UnitType
defines the unit's device type. Unit types and their supported devices
are shown in the following table.
旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴컫컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢nitType 쿏evices Supported � 쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢IB_TYPE_DISK 쿏irect access (DASD) � 쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢IB_TYPE_TAPE 쿟ape � 쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢IB_TYPE_PRINTER 쿛rinter � 쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢IB_TYPE_PROCESSOR 쿛rocessor � 쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢IB_TYPE_WORM 쿥rite Once/Read Many � 쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢IB_TYPE_CDROM 쿎D ROM � 쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢IB_TYPE_SCANNER 쿞canner � 쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢IB_TYPE_OPTICAL_MEMORY 쿚ptical disk � 쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢IB_TYPE_CHANGER 쿎hanger (example, jukebox) � 쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿢IB_TYPE_COMM 쿎ommunication � 읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴컨컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴�
Note: One unit type must be set.
QueuingCount
defines the recommended number of commands to queue for this unit.
Note: Do not design drivers assuming a fixed length queue.
This field provides to the device manager the recommended queue length for optimum performance.
UnitSCSITargetID
contains the target ID for SCSI devices. For all other devices, this field
equals 0.
UnitSCSILUN
contains the logical unit number for SCSI devices. For all other devices,
this field equals 0.
On exit, the driver sets the Status and ErrorCode fields of the IORBH to reflect the results of the IOCC_CONFIGURATION request.
Return Codes
Following is a list of the IOCC_CONFIGURATION error codes:
IOERR_CMD_SYNTAX
IOERR_CMD_SW_RESOURCE.
For a detailed description of all the return codes, see Error Handling.