AtapiFindPCIController函数是用来发现PCI总线上所有的IDE控制器，并发现相关的IDE设备。具体实现代码如下：
#001 ULONG
#002 NTAPI
#003 AtapiFindPCIController(
#004 IN PVOID HwDeviceExtension,
#005 IN PVOID Context,
#006 IN PVOID BusInformation,
#007 IN PCHAR ArgumentString,
#008 IN OUT PPORT_CONFIGURATION_INFORMATION ConfigInfo,
#009 OUT PBOOLEAN Again
#010 )
#011 /*++
#012
#013 Routine Description:
#014
#015 This function is called by the OS-specific port driver after
#016 the necessary storage has been allocated,to gather information
#017 about the adapter's configuration.
#018
#019 Arguments:
#020
#021 HwDeviceExtension - HBA miniport driver's adapter data storage
#022 Context - Address of adapter count
#023 BusInformation -
#024 ArgumentString - Used to determine whether driver is client of ntldr or crash dump utility.
#025 ConfigInfo - Configuration information structure describing HBA
#026 Again - Indicates search for adapters to continue
#027
#028 Return Value:
#029
#030 ULONG
#031
#032 --*/
#033
#034 {
#035 PHW_DEVICE_EXTENSION deviceExtension = HwDeviceExtension;
#036 PULONG adapterCount = (PULONG)Context;
#037 ULONG channel = 0;
#038 static ULONG functionNumber,
#039 slotNumber,
#040 controllers;
#041 ULONG i,j;
#042 PUCHAR ioSpace;
#043 BOOLEAN atapiOnly,
#044 lastSlot,
#045 controllerFound = FALSE,
#046 deviceFound = FALSE;
#047 UCHAR statusByte;
#048
#049 //
#050 // The following table specifies the ports to be checked when searching for
#051 // an IDE controller. A zero entry terminates the search.
#052 //
#053
这里设置IDE控制器的几个控制端口。
#054 CONST ULONG AdapterAddresses[5] = {0x1F0,0x170,0x1e8,0x168,0};
#055
#056 //
#057 // The following table specifies interrupt levels corresponding to the
#058 // port addresses in the prevIoUs table.
#059 //
#060
设置相应的IDE控制器的中断号。
#061 CONST ULONG InterruptLevels[5] = {14,15,11,10,0};
#062
检查设备对象扩展是否分配，如果没有分配，就返回失败。
#063 if (!deviceExtension) {
#064 return SP_RETURN_ERROR;
#065 }
#066
#067 //
#068 // Since scsiport will call this function first before it calls AtapiFindController
#069 // we need to bypass it if we have data installed in ConfigInfo,by the pcmcia driver.
#070 // In that case atapifindcontroller should be called first.
#071 // Instead of modifying atapi driverEntry to search of PCIBus first (now its ISA)
#072 // the check is put here.
#073 //
#074
当总线0上的设备配置不为空时，就进入进找相应的IDE控制器。
#075 if (ScsiPortConvertPhysicalAddressToUlong((*ConfigInfo->AccessRanges)[0].RangeStart) != 0) {
#076
下面调用函数AtapiFindController来发现相应的IDE控制器。
#077 return AtapiFindController(HwDeviceExtension,
#078 Context,
#079 BusInformation,
#080 ArgumentString,
#081 ConfigInfo,
#082 Again);
#083 }
#084
#085
#086 //
#087 // Gronk PCI config space looking for the broken PCI IDE controllers that have only
#088 // one FIFO for both channels.
#089 // Don't do this. It's incorrect and nasty. It has to be done to work around these
#090 // broken parts,no other reason can justify this.
#091 //
#092
下面查找分离的PCI设备配置空间。
#093 for (i = controllers; i < BROKEN_ADAPTERS; i++) {
#094
#095 //
#096 // Determine if both channels are enabled and have devices.
#097 //
#098
#099 lastSlot = FALSE;
#100
#101 if (FindBrokenController(deviceExtension,
#102 (PUCHAR)BrokenAdapters[i].VendorId,
#103 BrokenAdapters[i].VendorIdLength,
#104 (PUCHAR)BrokenAdapters[i].DeviceId,
#105 BrokenAdapters[i].DeviceIdLength,
#106 &functionNumber,
#107 &slotNumber,
#108 ConfigInfo->SystemIoBusNumber,
#109 &lastSlot)) {
#110
#111 slotNumber++;
#112 functionNumber = 0;
#113 controllerFound = TRUE;
#114
#115 DebugPrint((1,
#116 "Found broken PCI IDE controller: VendorId %s,DeviceId %s/n",
#117 BrokenAdapters[i].VendorId,
#118 BrokenAdapters[i].DeviceId));
#119
#120 if (AdapterAddresses[*adapterCount] != 0) {
#121
#122 for (j = 0; j < 2; j++) {
#123
#124 //
#125 // Get the system physical address for this IO range.
#126 //
#127
#128 ioSpace = ScsiPortGetDeviceBase(HwDeviceExtension,
#129 ConfigInfo->AdapterInterfaceType,
#130 ConfigInfo->SystemIoBusNumber,
#131 ScsiPortConvertUlongToPhysicalAddress(AdapterAddresses[*adapterCount]),
#132 8,
#133 TRUE);
#134
#135 //
#136 // Update the adapter count.
#137 //
#138
增加IDE控制器的个数。
#139 (*adapterCount)++;
#140
#141 //
#142 // Check if ioSpace accessible.
#143 //
#144
#145 if (!ioSpace) {
#146 continue;
#147 }
#148
#149 //
#150 // Select master.
#151 //
#152
#153 ScsiPortWritePortUchar(&((PIDE_REGISTERS_1)ioSpace)->DriveSelect,0xA0);
#154
#155 //
#156 // Check if card at this address.
#157 //
#158
#159 ScsiPortWritePortUchar(&((PIDE_REGISTERS_1)ioSpace)->CylinderLow,0xAA);
#160
#161 //
#162 // Check if indentifier can be read back.
#163 //
#164
#165 if ((statusByte = ScsiPortReadPortUchar(&((PIDE_REGISTERS_1)ioSpace)->CylinderLow)) != 0xAA) {
#166
#167 DebugPrint((2,
#168 "AtapiFindPciController: Identifier read back from Master (%x)/n",
#169 statusByte));
#170
#171
#172 //
#173 // Select slave.
#174 //
#175
#176 ScsiPortWritePortUchar(&((PIDE_REGISTERS_1)ioSpace)->DriveSelect,0xB0);
#177
#178 //
#179 // See if slave is present.
#180 //
#181
#182 ScsiPortWritePortUchar(&((PIDE_REGISTERS_1)ioSpace)->CylinderLow,0xAA);
#183
#184 if ((statusByte = ScsiPortReadPortUchar(&((PIDE_REGISTERS_1)ioSpace)->CylinderLow)) != 0xAA) {
#185
#186 DebugPrint((2,
#187 "AtapiFindPciController: Identifier read back from Slave (%x)/n",
#188 statusByte));
#189
#190 //
#191 //
#192 // No controller at this base address.
#193 //
#194
#195 ScsiPortFreeDeviceBase(HwDeviceExtension,
#196 ioSpace);
#197
继续查找第二个通道是否IDE控制器。
#198 //
#199 // If the chip is there,but we couldn't find the primary channel,try the secondary.
#200 // If we couldn't find a secondary,who cares.
#201 //
#202
#203 if (j == 1) {
#204
#205 goto setStatusAndExit;
#206
#207 } else {
#208 continue;
#209 }
#210 }
#211 }
#212
如果发现了IDE控制器，就保存相应的配置参数。
#213 if (controllerFound) {
#214
#215 //
#216 // Record base IO address.
#217 //
#218
#219 deviceExtension->BaseIoAddress1[channel] = (PIDE_REGISTERS_1)(ioSpace);
#220
#221 //
#222 // Fill in the access array information.
#223 //
#224
#225 (*ConfigInfo->AccessRanges)[channel].RangeStart =
#226 ScsiPortConvertUlongToPhysicalAddress(AdapterAddresses[*adapterCount - 1]);
#227
#228 (*ConfigInfo->AccessRanges)[channel].RangeLength = 8;
#229 (*ConfigInfo->AccessRanges)[channel].RangeInMemory = FALSE;
#230
#231 //
#232 // Indicate the interrupt level corresponding to this IO range.
#233 //
#234
根据不同的通道进行保存中断号和中断方式。
#235 if (channel == 0) {
#236 ConfigInfo->BusInterruptLevel = InterruptLevels[*adapterCount - 1];
#237 ConfigInfo->InterruptMode = Latched;
#238 } else {
#239 ConfigInfo->BusInterruptLevel2 = InterruptLevels[*adapterCount - 1];
#240 ConfigInfo->InterruptMode2 = Latched;
#241 }
#242
#243 //
#244 // Get the system physical address for the second IO range.
#245 //
#246
#247 ioSpace = ScsiPortGetDeviceBase(HwDeviceExtension,
#248 ConfigInfo->AdapterInterfaceType,
#249 ConfigInfo->SystemIoBusNumber,
#250 ScsiPortConvertUlongToPhysicalAddress(AdapterAddresses[*adapterCount - 1] + 0x206),
#251 1,
#252 TRUE);
#253
#254 deviceExtension->BaseIoAddress2[channel] = (PIDE_REGISTERS_2)(ioSpace);
#255
#256 deviceExtension->NumberChannels = 2;
#257
#258 //
#259 // Indicate only one bus.
#260 //
#261
#262 ConfigInfo->NumberOfBuses = 1;
#263
#264 //
#265 // Indicate four devices can be attached to the adapter,since we
#266 // have to serialize access to the two channels.
#267 //
#268
#269 ConfigInfo->MaximumNumberOfTargets = 4;
#270
#271 //
#272 // Indicate maximum transfer length is 64k.
#273 //
#274
#275 ConfigInfo->MaximumTransferLength = 0x10000;
#276
#277 DebugPrint((1,
#278 "AtapiFindPciController: Found broken IDE at %x/n",
#279 deviceExtension->BaseIoAddress1[channel]));
#280
#281 //
#282 // Since we will always pick up this part,and not atdisk,so indicate.
#283 //
#284
#285 atapiOnly = FALSE;
#286
保存中断模式。
#287 //
#288 // Save the Interrupe Mode for later use
#289 //
#290 deviceExtension->InterruptMode = ConfigInfo->InterruptMode;
#291
查找这个IDE控制器上所有的设备。
#292 //
#293 // Search for devices on this controller.
#294 //
#295
#296 if (FindDevices(HwDeviceExtension,
#297 atapiOnly,
#298 channel++)){
#299 deviceFound = TRUE;
#300 }
#301
判断是主IDE设备，还第二个IDE设备。
#302 //
#303 // Claim primary or secondary ATA IO range.
#304 //
#305
#306 if (*adapterCount == 1) {
#307 ConfigInfo->AtdiskPrimaryClaimed = TRUE;
#308 deviceExtension->PrimaryAddress = TRUE;
#309
#310 } else if (*adapterCount == 2) {
#311 ConfigInfo->AtdiskSecondaryClaimed = TRUE;
#312 deviceExtension->PrimaryAddress = FALSE;
#313 }
#314 }
#315 }
#316 }
#317 }
#318
#319 setStatusAndExit:
#320
#321 if (lastSlot) {
#322 slotNumber = 0;
#323 functionNumber = 0;
#324 }
#325
#326 controllers = i;
#327
#328 if (controllerFound && deviceFound) {
#329
返回已经搜索到设备。
#330 *Again = TRUE;
#331 return SP_RETURN_FOUND;
#332 }
#333 }
#334
#335
已经搜索完成，没有任设备发现。
#336 //
#337 // The entire table has been searched and no adapters have been found.
#338 //
#339
#340 *Again = FALSE;
#341
#342 return SP_RETURN_NOT_FOUND;
#343
#344} // end AtapiFindPCIController()
