1.1.1  Hardware Configuration

HalGetBusData

Returns bus-relative configuration information for the specified type of I/O bus, system-assigned bus number, slot number or device location, and a pointer to a driver-supplied buffer and the buffer’s length in bytes.

HalGetBusDataByOffset

Like HalGetBusData, returns bus-relative configuration information to a driver-supplied buffer. However, this routine returns configuration information for a given type of I/O bus, starting at the given offset in the bus-type-specific configuration data structure if the bus is dynamically configurable with a published standard interface.

IoAssignResources

Takes an input list of preferred and alternative, or required, hardware resources needed for a driver or device, inspects the registry for available hardware resources, claims hardware resources in the registry ResourceMap tree, and returns configuration information about the hardware resources it claimed for the caller.

HalAssignSlotResources

Like IoAssignResources, takes an input list of preferred and alternative hardware resources and claims available hardware resources in the registry ResourceMap tree, returning information about the resources it claimed to the caller. However, this routine claims hardware resources only for drivers of devices on any given type of dynamically configurable I/O bus with a published standard interface.

HalSetBusData

Sets I/O bus configuration data fora given slot or address on a particular bus.

HalSetBusDataByOffset

Sets I/O bus configuration data fora given slot or address on a particular bus, starting at the given offset in the bus-type-specific configuration structure.

IoQueryDeviceDescription

Supplies basic hardware information about one or more of the given bus type and bus number, controller type and controller number, and/or peripheral type and peripheral number from the registry to a driver-supplied configuration-callback routine. As an alternative, device drivers can call HalGetBusData or HalGetBusDataByOffset.

IoReportResourceUsage

Claims hardware resources, such as ports in I/O space or device registers in memory space, an interrupt vector, or a particular DMA controller channel, in the registry so that a subsequently loaded driver cannot attempt to use the same resources. To claim most types of resources, calling IoAssignResources or HalAssignSlotResources is preferable.

IoGetConfigurationInformation

Returns a pointer to the I/O Manager’s configuration information structure, which indicates the number of disk, floppy, CD-ROM, tape, SCSI HBAs, serial, and parallel device objects that have already been named by previously loaded drivers, as well as whether certain address ranges have been claimed by “AT” disk-type drivers.

HalTranslateBusAddress

Returns the corresponding physical address in system memory for a given bus-specific logical address.

HalGetInterruptVector

Returns a mapped system interrupt vector, DIRQL, and processor-affinity mask a driver can use to set up its interrupt service routine (ISR), given the type of bus on which the driver’s device is connected, the system-assigned bus number, and the bus’s interrupt vector and IRQL.

HalGetAdapter

Returns a pointer to the adapter object representing the DMA channel to which the driver’s device is connected or representing the driver’s busmaster adapter, together with the maximum number of map registers the driver can specify for each DMA transfer, given the input device description.

HalExamineMBR

Returns data from the master boot record (MBR) of a disk.

KeGetDcacheFillSize

Returns the processor’s data cache-line boundary.

IoReadPartitionTable

Returns a list of partitions on a disk with a given sector size.