isapnp.h File Reference

#include <ntddk.h>
#include <ntstrsafe.h>
#include <section_attribs.h>
#include "isapnphw.h"
#include <initguid.h>
#include <wdmguid.h>

Include dependency graph for isapnp.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	_ISAPNP_IO
struct	_ISAPNP_IRQ
struct	_ISAPNP_DMA
struct	_ISAPNP_MEMRANGE
struct	_ISAPNP_MEMRANGE32
struct	_ISAPNP_COMPATIBLE_ID_ENTRY
struct	_ISAPNP_ALTERNATIVES
struct	_ISAPNP_LOGICAL_DEVICE
struct	_ISAPNP_COMMON_EXTENSION
struct	_ISAPNP_FDO_EXTENSION
struct	_ISAPNP_PDO_EXTENSION

Macros
#define	TAG_ISAPNP   'pasI'
#define	ISAPNP_MAX_RESOURCEDATA   0x1000
	Maximum size of resource data structure supported by the driver. More...
#define	ISAPNP_MAX_ALTERNATIVES   8
	Maximum number of Start DF tags supported by the driver. More...
#define	ISAPNP_PRESENT   0x00000001
	Cleared when the device is physically removed. More...
#define	ISAPNP_HAS_MULTIPLE_LOGDEVS   0x00000002
	Indicates if the parent card has multiple logical devices. More...
#define	ISAPNP_HAS_RESOURCES   0x00000004
	Cleared when the device has no boot resources. More...
#define	ISAPNP_ENUMERATED   0x00000001
	Whether the device has been reported to the PnP manager. More...
#define	ISAPNP_SCANNED_BY_READ_PORT   0x00000002
	The bus has been scanned by Read Port PDO. More...
#define	ISAPNP_READ_PORT_ALLOW_FDO_SCAN   0x00000004
	Allows the active FDO to scan the bus. More...
#define	ISAPNP_READ_PORT_NEED_REBALANCE   0x00000008
	The I/O resource requirements have changed. More...

Typedefs
typedef struct _ISAPNP_IO	ISAPNP_IO
typedef struct _ISAPNP_IO *	PISAPNP_IO
typedef struct _ISAPNP_IRQ	ISAPNP_IRQ
typedef struct _ISAPNP_IRQ *	PISAPNP_IRQ
typedef struct _ISAPNP_DMA	ISAPNP_DMA
typedef struct _ISAPNP_DMA *	PISAPNP_DMA
typedef struct _ISAPNP_MEMRANGE	ISAPNP_MEMRANGE
typedef struct _ISAPNP_MEMRANGE *	PISAPNP_MEMRANGE
typedef struct _ISAPNP_MEMRANGE32	ISAPNP_MEMRANGE32
typedef struct _ISAPNP_MEMRANGE32 *	PISAPNP_MEMRANGE32
typedef struct _ISAPNP_COMPATIBLE_ID_ENTRY	ISAPNP_COMPATIBLE_ID_ENTRY
typedef struct _ISAPNP_COMPATIBLE_ID_ENTRY *	PISAPNP_COMPATIBLE_ID_ENTRY
typedef struct _ISAPNP_ALTERNATIVES	ISAPNP_ALTERNATIVES
typedef struct _ISAPNP_ALTERNATIVES *	PISAPNP_ALTERNATIVES
typedef struct _ISAPNP_LOGICAL_DEVICE	ISAPNP_LOGICAL_DEVICE
typedef struct _ISAPNP_LOGICAL_DEVICE *	PISAPNP_LOGICAL_DEVICE
typedef enum _ISAPNP_SIGNATURE	ISAPNP_SIGNATURE
typedef struct _ISAPNP_COMMON_EXTENSION	ISAPNP_COMMON_EXTENSION
typedef struct _ISAPNP_COMMON_EXTENSION *	PISAPNP_COMMON_EXTENSION
typedef struct _ISAPNP_FDO_EXTENSION	ISAPNP_FDO_EXTENSION
typedef struct _ISAPNP_FDO_EXTENSION *	PISAPNP_FDO_EXTENSION
typedef struct _ISAPNP_PDO_EXTENSION	ISAPNP_PDO_EXTENSION
typedef struct _ISAPNP_PDO_EXTENSION *	PISAPNP_PDO_EXTENSION

Enumerations
enum	ISAPNP_DEVICE_STATE { dsStopped, dsStarted }
enum	_ISAPNP_SIGNATURE { IsaPnpBus = 'odFI', IsaPnpLogicalDevice = 'veDI', IsaPnpReadDataPort = 'pdRI' }

Functions
	_Guarded_by_ (BusSyncEvent) extern BOOLEAN ReadPortCreated
	_Requires_lock_not_held_ (BusSyncEvent) _Acquires_lock_(BusSyncEvent) FORCEINLINE VOID IsaPnpAcquireBusDataLock(VOID)
	_Releases_lock_ (BusSyncEvent) FORCEINLINE VOID IsaPnpReleaseBusDataLock(VOID)
	_Requires_lock_not_held_ (FdoExt->DeviceSyncEvent) _Acquires_lock_(FdoExt -> DeviceSyncEvent) FORCEINLINE VOID IsaPnpAcquireDeviceDataLock(_In_ PISAPNP_FDO_EXTENSION FdoExt)
	_Releases_lock_ (FdoExt->DeviceSyncEvent) FORCEINLINE VOID IsaPnpReleaseDeviceDataLock(_In_ PISAPNP_FDO_EXTENSION FdoExt)
FORCEINLINE BOOLEAN	HasIoAlternatives (_In_ PISAPNP_ALTERNATIVES Alternatives)
FORCEINLINE BOOLEAN	HasIrqAlternatives (_In_ PISAPNP_ALTERNATIVES Alternatives)
FORCEINLINE BOOLEAN	HasDmaAlternatives (_In_ PISAPNP_ALTERNATIVES Alternatives)
FORCEINLINE BOOLEAN	HasMemoryAlternatives (_In_ PISAPNP_ALTERNATIVES Alternatives)
FORCEINLINE BOOLEAN	HasMemory32Alternatives (_In_ PISAPNP_ALTERNATIVES Alternatives)
BOOLEAN	FindIoDescriptor (_In_ PISAPNP_LOGICAL_DEVICE LogDevice, _In_opt_ ULONG Base, _In_ ULONG RangeStart, _In_ ULONG RangeEnd, _Out_opt_ PUCHAR Information, _Out_opt_ PULONG Length, _Out_opt_ PUCHAR WriteOrder)
BOOLEAN	FindIrqDescriptor (_In_ PISAPNP_LOGICAL_DEVICE LogDevice, _In_ ULONG Vector, _Out_opt_ PUCHAR WriteOrder)
BOOLEAN	FindDmaDescriptor (_In_ PISAPNP_LOGICAL_DEVICE LogDevice, _In_ ULONG Channel, _Out_opt_ PUCHAR WriteOrder)
BOOLEAN	FindMemoryDescriptor (_In_ PISAPNP_LOGICAL_DEVICE LogDevice, _In_ ULONG RangeStart, _In_ ULONG RangeEnd, _Out_opt_ PBOOLEAN Memory32, _Out_opt_ PUCHAR Information, _Out_opt_ PUCHAR WriteOrder)
NTSTATUS	IsaPnpCreateReadPortDORequirements (_In_ PISAPNP_PDO_EXTENSION PdoExt, _In_opt_ ULONG SelectedReadPort)
VOID	IsaPnpRemoveReadPortDO (_In_ PDEVICE_OBJECT Pdo)
NTSTATUS	IsaPnpFillDeviceRelations (_In_ PISAPNP_FDO_EXTENSION FdoExt, _Inout_ PIRP Irp, _In_ BOOLEAN IncludeDataPort)
NTSTATUS	IsaFdoPnp (_In_ PISAPNP_FDO_EXTENSION FdoExt, _Inout_ PIRP Irp, _In_ PIO_STACK_LOCATION IrpSp)
NTSTATUS	IsaFdoQueryInterface (_In_ PISAPNP_FDO_EXTENSION FdoExt, _In_ PIO_STACK_LOCATION IrpSp)
NTSTATUS	IsaPdoPnp (_In_ PISAPNP_PDO_EXTENSION PdoDeviceExtension, _Inout_ PIRP Irp, _In_ PIO_STACK_LOCATION IrpSp)
VOID	IsaPnpRemoveLogicalDeviceDO (_In_ PDEVICE_OBJECT Pdo)
UCHAR	IsaHwTryReadDataPort (_In_ PUCHAR ReadDataPort)
	_Requires_lock_held_ (FdoExt->DeviceSyncEvent) NTSTATUS IsaHwFillDeviceList(_In_ PISAPNP_FDO_EXTENSION FdoExt)
NTSTATUS	IsaHwConfigureDevice (_In_ PISAPNP_FDO_EXTENSION FdoExt, _In_ PISAPNP_LOGICAL_DEVICE LogicalDevice, _In_ PCM_RESOURCE_LIST Resources)
	_IRQL_requires_max_ (DISPATCH_LEVEL) VOID IsaHwWakeDevice(_In_ PISAPNP_LOGICAL_DEVICE LogicalDevice)

Variables
KEVENT	BusSyncEvent
DRIVER_INITIALIZE	DriverEntry
_In_ PISAPNP_LOGICAL_DEVICE	LogicalDevice

Macro Definition Documentation

ISAPNP_ENUMERATED

#define ISAPNP_ENUMERATED   0x00000001

Whether the device has been reported to the PnP manager.

Definition at line 187 of file isapnp.h.

ISAPNP_HAS_MULTIPLE_LOGDEVS

#define ISAPNP_HAS_MULTIPLE_LOGDEVS   0x00000002

Indicates if the parent card has multiple logical devices.

Definition at line 135 of file isapnp.h.

ISAPNP_HAS_RESOURCES

#define ISAPNP_HAS_RESOURCES   0x00000004

Cleared when the device has no boot resources.

Definition at line 136 of file isapnp.h.

ISAPNP_MAX_ALTERNATIVES

#define ISAPNP_MAX_ALTERNATIVES   8

Maximum number of Start DF tags supported by the driver.

Definition at line 30 of file isapnp.h.

ISAPNP_MAX_RESOURCEDATA

#define ISAPNP_MAX_RESOURCEDATA   0x1000

Maximum size of resource data structure supported by the driver.

Definition at line 27 of file isapnp.h.

ISAPNP_PRESENT

#define ISAPNP_PRESENT   0x00000001

Cleared when the device is physically removed.

Definition at line 134 of file isapnp.h.

ISAPNP_READ_PORT_ALLOW_FDO_SCAN

#define ISAPNP_READ_PORT_ALLOW_FDO_SCAN   0x00000004

Allows the active FDO to scan the bus.

Definition at line 189 of file isapnp.h.

ISAPNP_READ_PORT_NEED_REBALANCE

#define ISAPNP_READ_PORT_NEED_REBALANCE   0x00000008

The I/O resource requirements have changed.

Definition at line 190 of file isapnp.h.

ISAPNP_SCANNED_BY_READ_PORT

#define ISAPNP_SCANNED_BY_READ_PORT   0x00000002

The bus has been scanned by Read Port PDO.

Definition at line 188 of file isapnp.h.

TAG_ISAPNP

#define TAG_ISAPNP   'pasI'

Definition at line 24 of file isapnp.h.

Typedef Documentation

ISAPNP_ALTERNATIVES

typedef struct _ISAPNP_ALTERNATIVES ISAPNP_ALTERNATIVES

ISAPNP_COMMON_EXTENSION

typedef struct _ISAPNP_COMMON_EXTENSION ISAPNP_COMMON_EXTENSION

ISAPNP_COMPATIBLE_ID_ENTRY

typedef struct _ISAPNP_COMPATIBLE_ID_ENTRY ISAPNP_COMPATIBLE_ID_ENTRY

ISAPNP_DMA

typedef struct _ISAPNP_DMA ISAPNP_DMA

ISAPNP_FDO_EXTENSION

typedef struct _ISAPNP_FDO_EXTENSION ISAPNP_FDO_EXTENSION

ISAPNP_IO

typedef struct _ISAPNP_IO ISAPNP_IO

ISAPNP_IRQ

typedef struct _ISAPNP_IRQ ISAPNP_IRQ

ISAPNP_LOGICAL_DEVICE

typedef struct _ISAPNP_LOGICAL_DEVICE ISAPNP_LOGICAL_DEVICE

ISAPNP_MEMRANGE

typedef struct _ISAPNP_MEMRANGE ISAPNP_MEMRANGE

ISAPNP_MEMRANGE32

typedef struct _ISAPNP_MEMRANGE32 ISAPNP_MEMRANGE32

ISAPNP_PDO_EXTENSION

typedef struct _ISAPNP_PDO_EXTENSION ISAPNP_PDO_EXTENSION

ISAPNP_SIGNATURE

typedef enum _ISAPNP_SIGNATURE ISAPNP_SIGNATURE

PISAPNP_ALTERNATIVES

typedef struct _ISAPNP_ALTERNATIVES * PISAPNP_ALTERNATIVES

PISAPNP_COMMON_EXTENSION

typedef struct _ISAPNP_COMMON_EXTENSION * PISAPNP_COMMON_EXTENSION

PISAPNP_COMPATIBLE_ID_ENTRY

typedef struct _ISAPNP_COMPATIBLE_ID_ENTRY * PISAPNP_COMPATIBLE_ID_ENTRY

PISAPNP_DMA

typedef struct _ISAPNP_DMA * PISAPNP_DMA

PISAPNP_FDO_EXTENSION

typedef struct _ISAPNP_FDO_EXTENSION * PISAPNP_FDO_EXTENSION

PISAPNP_IO

typedef struct _ISAPNP_IO * PISAPNP_IO

PISAPNP_IRQ

typedef struct _ISAPNP_IRQ * PISAPNP_IRQ

PISAPNP_LOGICAL_DEVICE

typedef struct _ISAPNP_LOGICAL_DEVICE * PISAPNP_LOGICAL_DEVICE

PISAPNP_MEMRANGE

typedef struct _ISAPNP_MEMRANGE * PISAPNP_MEMRANGE

PISAPNP_MEMRANGE32

typedef struct _ISAPNP_MEMRANGE32 * PISAPNP_MEMRANGE32

PISAPNP_PDO_EXTENSION

typedef struct _ISAPNP_PDO_EXTENSION * PISAPNP_PDO_EXTENSION

Enumeration Type Documentation

_ISAPNP_SIGNATURE

enum _ISAPNP_SIGNATURE

Enumerator
IsaPnpBus
IsaPnpLogicalDevice
IsaPnpReadDataPort

Definition at line 141 of file isapnp.h.

{
    IsaPnpBus = 'odFI',
    IsaPnpLogicalDevice = 'veDI',
    IsaPnpReadDataPort = 'pdRI'
} ISAPNP_SIGNATURE;

ISAPNP_DEVICE_STATE

enum ISAPNP_DEVICE_STATE

Enumerator
dsStopped
dsStarted

Definition at line 32 of file isapnp.h.

{
    dsStopped,
    dsStarted
} ISAPNP_DEVICE_STATE;

Function Documentation

_Guarded_by_()

_Guarded_by_

(

BusSyncEvent

)

Definition at line 23 of file isapnp.c.

{
    PAGED_CODE();

    return Priority[*(PUCHAR)A] - Priority[*(PUCHAR)B];
}

_IRQL_requires_max_()

_IRQL_requires_max_

(

DISPATCH_LEVEL

)

Definition at line 1705 of file hardware.c.

{
    SendKey();
    Wake(LogicalDevice->CSN);
}

_Releases_lock_() [1/2]

_Releases_lock_

(

BusSyncEvent

)

Definition at line 213 of file isapnp.h.

{
    KeSetEvent(&BusSyncEvent, IO_NO_INCREMENT, FALSE);
}

_Releases_lock_() [2/2]

_Releases_lock_

(

FdoExt->

DeviceSyncEvent

)

Definition at line 231 of file isapnp.h.

{
    KeSetEvent(&FdoExt->DeviceSyncEvent, IO_NO_INCREMENT, FALSE);
}

_Requires_lock_held_()

_Requires_lock_held_

(

FdoExt->

DeviceSyncEvent

)

Definition at line 1460 of file hardware.c.

{
    PISAPNP_LOGICAL_DEVICE LogDevice;
    UCHAR Csn;
    PLIST_ENTRY Entry;
    PUCHAR ResourceData;

    PAGED_CODE();
    ASSERT(FdoExt->ReadDataPort);

    DPRINT("%s for read port 0x%p\n", __FUNCTION__, FdoExt->ReadDataPort);

    ResourceData = ExAllocatePoolWithTag(PagedPool, ISAPNP_MAX_RESOURCEDATA, TAG_ISAPNP);
    if (!ResourceData)
    {
        DPRINT1("Failed to allocate memory for cache data\n");
        return STATUS_INSUFFICIENT_RESOURCES;
    }

    for (Entry = FdoExt->DeviceListHead.Flink;
         Entry != &FdoExt->DeviceListHead;
         Entry = Entry->Flink)
    {
        LogDevice = CONTAINING_RECORD(Entry, ISAPNP_LOGICAL_DEVICE, DeviceLink);

        LogDevice->Flags &= ~ISAPNP_PRESENT;
    }

    for (Csn = 1; Csn <= FdoExt->Cards; Csn++)
    {
        NTSTATUS Status;
        UCHAR TempId[3], LogDev;
        ISAPNP_IDENTIFIER Identifier;
        USHORT MaxLogDev;

        Wake(Csn);

        Peek(FdoExt->ReadDataPort, &Identifier, sizeof(Identifier));

        IsaPnpExtractAscii(TempId, Identifier.VendorId);
        Identifier.ProdId = RtlUshortByteSwap(Identifier.ProdId);

        Status = ReadTags(FdoExt->ReadDataPort, ResourceData, ISAPNP_MAX_RESOURCEDATA, &MaxLogDev);
        if (!NT_SUCCESS(Status))
        {
            DPRINT1("Failed to read tags with status 0x%08lx, CSN %u\n", Status, Csn);
            continue;
        }

        DPRINT("Detected ISA PnP device - VID: '%.3s' PID: 0x%04x SN: 0x%08lX\n",
               TempId, Identifier.ProdId, Identifier.Serial);

        for (LogDev = 0; LogDev < MaxLogDev; LogDev++)
        {
            BOOLEAN IsAlreadyEnumerated = FALSE;

            for (Entry = FdoExt->DeviceListHead.Flink;
                 Entry != &FdoExt->DeviceListHead;
                 Entry = Entry->Flink)
            {
                LogDevice = CONTAINING_RECORD(Entry, ISAPNP_LOGICAL_DEVICE, DeviceLink);

                /* This logical device has already been enumerated */
                if ((LogDevice->SerialNumber == Identifier.Serial) &&
                    (RtlCompareMemory(LogDevice->VendorId, TempId, 3) == 3) &&
                    (LogDevice->ProdId == Identifier.ProdId) &&
                    (LogDevice->LDN == LogDev))
                {
                    LogDevice->Flags |= ISAPNP_PRESENT;

                    /* Assign a new CSN */
                    LogDevice->CSN = Csn;

                    if (LogDevice->Pdo)
                    {
                        PISAPNP_PDO_EXTENSION PdoExt = LogDevice->Pdo->DeviceExtension;

                        if (PdoExt->Common.State == dsStarted)
                            ActivateDevice(FdoExt->ReadDataPort, LogDev);
                    }

                    DPRINT("Skip CSN %u, LDN %u\n", LogDevice->CSN, LogDevice->LDN);
                    IsAlreadyEnumerated = TRUE;
                    break;
                }
            }

            if (IsAlreadyEnumerated)
                continue;

            LogDevice = ExAllocatePoolZero(NonPagedPool, sizeof(ISAPNP_LOGICAL_DEVICE), TAG_ISAPNP);
            if (!LogDevice)
            {
                DPRINT1("Failed to allocate logical device!\n");
                goto Deactivate;
            }

            InitializeListHead(&LogDevice->CompatibleIdList);

            LogDevice->CSN = Csn;
            LogDevice->LDN = LogDev;

            Status = ParseTags(ResourceData, LogDev, LogDevice);
            if (!NT_SUCCESS(Status))
            {
                DPRINT1("Failed to parse tags with status 0x%08lx, CSN %u, LDN %u\n",
                        Status, LogDevice->CSN, LogDevice->LDN);
                FreeLogicalDevice(LogDevice);
                goto Deactivate;
            }

            if (!ReadCurrentResources(FdoExt->ReadDataPort, LogDevice))
                DPRINT("Unable to read boot resources\n");

            IsaPnpExtractAscii(LogDevice->VendorId, Identifier.VendorId);
            LogDevice->ProdId = Identifier.ProdId;
            LogDevice->SerialNumber = Identifier.Serial;

            if (MaxLogDev > 1)
                LogDevice->Flags |= ISAPNP_HAS_MULTIPLE_LOGDEVS;

            LogDevice->Flags |= ISAPNP_PRESENT;

            InsertTailList(&FdoExt->DeviceListHead, &LogDevice->DeviceLink);
            FdoExt->DeviceCount++;

            /* Now we wait for the start device IRP */
Deactivate:
            DeactivateDevice(LogDev);
        }
    }

    ExFreePoolWithTag(ResourceData, TAG_ISAPNP);

    return STATUS_SUCCESS;
}

_Requires_lock_not_held_() [1/2]

_Requires_lock_not_held_

(

BusSyncEvent

)

Definition at line 204 of file isapnp.h.

{
    KeWaitForSingleObject(&BusSyncEvent, Executive, KernelMode, FALSE, NULL);
}

_Requires_lock_not_held_() [2/2]

_Requires_lock_not_held_

(

FdoExt->

DeviceSyncEvent

)

-> DeviceSyncEvent) FORCEINLINE VOID IsaPnpAcquireDeviceDataLock( _In_ PISAPNP_FDO_EXTENSION FdoExt)

Definition at line 221 of file isapnp.h.

{
    KeWaitForSingleObject(&FdoExt->DeviceSyncEvent, Executive, KernelMode, FALSE, NULL);
}

FindDmaDescriptor()

BOOLEAN FindDmaDescriptor	(	_In_ PISAPNP_LOGICAL_DEVICE	LogDevice,
		_In_ ULONG	Channel,
		_Out_opt_ PUCHAR	WriteOrder
	)

Definition at line 639 of file isapnp.c.

{
    ULONG i, j;
    PISAPNP_DMA_DESCRIPTION Description;

    PAGED_CODE();

    for (i = 0; i < RTL_NUMBER_OF(LogDevice->Dma); i++)
    {
        Description = &LogDevice->Dma[i].Description;

        for (j = 0; j < RTL_BITS_OF(Description->Mask); j++)
        {
            if (Description->Mask & (1 << j))
            {
                if (j == Channel)
                {
                    if (WriteOrder)
                        *WriteOrder = LogDevice->Dma[i].Index;

                    return TRUE;
                }
            }
        }
    }

    if (!LogDevice->Alternatives)
        return FALSE;

    for (i = 0; i < LogDevice->Alternatives->Count; i++)
    {
        Description = &LogDevice->Alternatives->Dma[i];

        for (j = 0; j < RTL_BITS_OF(Description->Mask); j++)
        {
            if (Description->Mask & (1 << j))
            {
                if (j == Channel)
                {
                    if (WriteOrder)
                        *WriteOrder = LogDevice->Alternatives->DmaIndex;

                    return TRUE;
                }
            }
        }
    }

    return FALSE;
}

Referenced by IsaHwConfigureDevice(), IsaPnpCreateLogicalDeviceResources(), and WriteResources().

FindIoDescriptor()

BOOLEAN FindIoDescriptor	(	_In_ PISAPNP_LOGICAL_DEVICE	LogDevice,
		_In_opt_ ULONG	Base,
		_In_ ULONG	RangeStart,
		_In_ ULONG	RangeEnd,
		_Out_opt_ PUCHAR	Information,
		_Out_opt_ PULONG	Length,
		_Out_opt_ PUCHAR	WriteOrder
	)

Definition at line 518 of file isapnp.c.

{
    ULONG i;
    BOOLEAN Match;
    PISAPNP_IO_DESCRIPTION Description;

    PAGED_CODE();

    for (i = 0; i < RTL_NUMBER_OF(LogDevice->Io); i++)
    {
        Description = &LogDevice->Io[i].Description;

        Match = Base ? (Base >= Description->Minimum) && (Base <= Description->Maximum)
                     : (RangeStart >= Description->Minimum) &&
                       (RangeEnd <= (ULONG)(Description->Maximum + Description->Length - 1));

        if (Match)
        {
            if (Information)
                *Information = Description->Information;
            if (Length)
                *Length = Description->Length;
            if (WriteOrder)
                *WriteOrder = LogDevice->Io[i].Index;

            return TRUE;
        }
    }

    if (!LogDevice->Alternatives)
        return FALSE;

    for (i = 0; i < LogDevice->Alternatives->Count; i++)
    {
        Description = &LogDevice->Alternatives->Io[i];

        Match = Base ? (Base >= Description->Minimum) && (Base <= Description->Maximum)
                     : (RangeStart >= Description->Minimum) &&
                       (RangeEnd <= (ULONG)(Description->Maximum + Description->Length - 1));

        if (Match)
        {
            if (Information)
                *Information = Description->Information;
            if (Length)
                *Length = Description->Length;
            if (WriteOrder)
                *WriteOrder = LogDevice->Alternatives->IoIndex;

            return TRUE;
        }
    }

    return FALSE;
}

Referenced by IsaHwConfigureDevice(), IsaPnpCreateLogicalDeviceResources(), and WriteResources().

FindIrqDescriptor()

BOOLEAN FindIrqDescriptor	(	_In_ PISAPNP_LOGICAL_DEVICE	LogDevice,
		_In_ ULONG	Vector,
		_Out_opt_ PUCHAR	WriteOrder
	)

Definition at line 583 of file isapnp.c.

{
    ULONG i, j;
    PISAPNP_IRQ_DESCRIPTION Description;

    PAGED_CODE();

    for (i = 0; i < RTL_NUMBER_OF(LogDevice->Irq); i++)
    {
        Description = &LogDevice->Irq[i].Description;

        for (j = 0; j < RTL_BITS_OF(Description->Mask); j++)
        {
            if (Description->Mask & (1 << j))
            {
                if (j == Vector)
                {
                    if (WriteOrder)
                        *WriteOrder = LogDevice->Irq[i].Index;

                    return TRUE;
                }
            }
        }
    }

    if (!LogDevice->Alternatives)
        return FALSE;

    for (i = 0; i < LogDevice->Alternatives->Count; i++)
    {
        Description = &LogDevice->Alternatives->Irq[i];

        for (j = 0; j < RTL_BITS_OF(Description->Mask); j++)
        {
            if (Description->Mask & (1 << j))
            {
                if (j == Vector)
                {
                    if (WriteOrder)
                        *WriteOrder = LogDevice->Alternatives->IrqIndex;

                    return TRUE;
                }
            }
        }
    }

    return FALSE;
}

Referenced by IsaHwConfigureDevice(), IsaPnpCreateLogicalDeviceResources(), and WriteResources().

FindMemoryDescriptor()

BOOLEAN FindMemoryDescriptor	(	_In_ PISAPNP_LOGICAL_DEVICE	LogDevice,
		_In_ ULONG	RangeStart,
		_In_ ULONG	RangeEnd,
		_Out_opt_ PBOOLEAN	Memory32,
		_Out_opt_ PUCHAR	Information,
		_Out_opt_ PUCHAR	WriteOrder
	)

Definition at line 695 of file isapnp.c.

{
    ULONG i;
    PISAPNP_MEMRANGE_DESCRIPTION Description;
    PISAPNP_MEMRANGE32_DESCRIPTION Description32;

    PAGED_CODE();

    for (i = 0; i < RTL_NUMBER_OF(LogDevice->MemRange); i++)
    {
        Description = &LogDevice->MemRange[i].Description;

        if ((RangeStart >= (ULONG)(Description->Minimum << 8)) &&
            (RangeEnd <= (ULONG)((Description->Maximum << 8) + (Description->Length << 8) - 1)))
        {
            if (Memory32)
                *Memory32 = FALSE;
            if (Information)
                *Information = Description->Information;
            if (WriteOrder)
                *WriteOrder = LogDevice->MemRange[i].Index;

            return TRUE;
        }
    }
    for (i = 0; i < RTL_NUMBER_OF(LogDevice->MemRange32); i++)
    {
        Description32 = &LogDevice->MemRange32[i].Description;

        if ((RangeStart >= Description32->Minimum) &&
            (RangeEnd <= (Description32->Maximum + Description32->Length - 1)))
        {
            if (Memory32)
                *Memory32 = TRUE;
            if (Information)
                *Information = Description32->Information;
            if (WriteOrder)
                *WriteOrder = LogDevice->MemRange32[i].Index;

            return TRUE;
        }
    }

    if (!LogDevice->Alternatives)
        return FALSE;

    for (i = 0; i < LogDevice->Alternatives->Count; i++)
    {
        Description = &LogDevice->Alternatives->MemRange[i];

        if ((RangeStart >= (ULONG)(Description->Minimum << 8)) &&
            (RangeEnd <= (ULONG)((Description->Maximum << 8) + (Description->Length << 8) - 1)))
        {
            if (Memory32)
                *Memory32 = FALSE;
            if (Information)
                *Information = Description->Information;
            if (WriteOrder)
                *WriteOrder = LogDevice->Alternatives->MemRangeIndex;

            return TRUE;
        }
    }
    for (i = 0; i < LogDevice->Alternatives->Count; i++)
    {
        Description32 = &LogDevice->Alternatives->MemRange32[i];

        if ((RangeStart >= Description32->Minimum) &&
            (RangeEnd <= (Description32->Maximum + Description32->Length - 1)))
        {
            if (Memory32)
                *Memory32 = TRUE;
            if (Information)
                *Information = Description32->Information;
            if (WriteOrder)
                *WriteOrder = LogDevice->Alternatives->MemRange32Index;

            return TRUE;
        }
    }

    return FALSE;
}

Referenced by IsaHwConfigureDevice(), IsaPnpCreateLogicalDeviceResources(), and WriteResources().

HasDmaAlternatives()

FORCEINLINE BOOLEAN HasDmaAlternatives

(

_In_ PISAPNP_ALTERNATIVES

Alternatives

)

Definition at line 258 of file isapnp.h.

{
    return (Alternatives->Dma[0].Mask != 0);
}

Referenced by IsaPnpCreateLogicalDeviceRequirements(), and ParseTags().

HasIoAlternatives()

FORCEINLINE BOOLEAN HasIoAlternatives

(

_In_ PISAPNP_ALTERNATIVES

Alternatives

)

Definition at line 242 of file isapnp.h.

{
    return (Alternatives->Io[0].Length != 0);
}

Referenced by IsaPnpCreateLogicalDeviceRequirements(), and ParseTags().

HasIrqAlternatives()

FORCEINLINE BOOLEAN HasIrqAlternatives

(

_In_ PISAPNP_ALTERNATIVES

Alternatives

)

Definition at line 250 of file isapnp.h.

{
    return (Alternatives->Irq[0].Mask != 0);
}

Referenced by IsaPnpCreateLogicalDeviceRequirements(), and ParseTags().

HasMemory32Alternatives()

FORCEINLINE BOOLEAN HasMemory32Alternatives

(

_In_ PISAPNP_ALTERNATIVES

Alternatives

)

Definition at line 274 of file isapnp.h.

{
    return (Alternatives->MemRange32[0].Length != 0);
}

Referenced by IsaPnpCreateLogicalDeviceRequirements(), and ParseTags().

HasMemoryAlternatives()

FORCEINLINE BOOLEAN HasMemoryAlternatives

(

_In_ PISAPNP_ALTERNATIVES

Alternatives

)

Definition at line 266 of file isapnp.h.

{
    return (Alternatives->MemRange[0].Length != 0);
}

Referenced by IsaPnpCreateLogicalDeviceRequirements(), and ParseTags().

IsaFdoPnp()

NTSTATUS IsaFdoPnp	(	_In_ PISAPNP_FDO_EXTENSION	FdoExt,
		_Inout_ PIRP	Irp,
		_In_ PIO_STACK_LOCATION	IrpSp
	)

Definition at line 123 of file fdo.c.

{
    NTSTATUS Status;

    PAGED_CODE();

    DPRINT("%s(%p, %p) FDO %lu, Minor - %X\n",
           __FUNCTION__,
           FdoExt,
           Irp,
           FdoExt->BusNumber,
           IrpSp->MinorFunction);

    switch (IrpSp->MinorFunction)
    {
        case IRP_MN_START_DEVICE:
            Status = IsaFdoStartDevice(FdoExt, Irp);

            Irp->IoStatus.Status = Status;
            IoCompleteRequest(Irp, IO_NO_INCREMENT);
            return Status;

        case IRP_MN_QUERY_DEVICE_RELATIONS:
        {
            if (IrpSp->Parameters.QueryDeviceRelations.Type != BusRelations)
                break;

            Status = IsaFdoQueryBusRelations(FdoExt, Irp);
            if (!NT_SUCCESS(Status))
            {
                Irp->IoStatus.Status = Status;
                IoCompleteRequest(Irp, IO_NO_INCREMENT);

                return Status;
            }

            Irp->IoStatus.Status = Status;
            break;
        }

        case IRP_MN_REMOVE_DEVICE:
            return IsaFdoRemoveDevice(FdoExt, Irp);

        case IRP_MN_QUERY_PNP_DEVICE_STATE:
            Irp->IoStatus.Information |= PNP_DEVICE_NOT_DISABLEABLE;
            Irp->IoStatus.Status = STATUS_SUCCESS;
            break;

        case IRP_MN_QUERY_INTERFACE:
        {
            Status = IsaFdoQueryInterface(FdoExt, IrpSp);
            if (Status == STATUS_NOT_SUPPORTED)
            {
                break;
            }
            else if (!NT_SUCCESS(Status))
            {
                Irp->IoStatus.Status = Status;
                IoCompleteRequest(Irp, IO_NO_INCREMENT);

                return Status;
            }

            Irp->IoStatus.Status = Status;
            break;
        }

        case IRP_MN_SURPRISE_REMOVAL:
        case IRP_MN_QUERY_STOP_DEVICE:
        case IRP_MN_QUERY_REMOVE_DEVICE:
        case IRP_MN_CANCEL_STOP_DEVICE:
        case IRP_MN_CANCEL_REMOVE_DEVICE:
        case IRP_MN_STOP_DEVICE:
            Irp->IoStatus.Status = STATUS_SUCCESS;
            break;

        default:
            DPRINT("Unknown PnP code: %X\n", IrpSp->MinorFunction);
            break;
    }

    IoSkipCurrentIrpStackLocation(Irp);

    return IoCallDriver(FdoExt->Ldo, Irp);
}

Referenced by _Dispatch_type_().

IsaFdoQueryInterface()

NTSTATUS IsaFdoQueryInterface	(	_In_ PISAPNP_FDO_EXTENSION	FdoExt,
		_In_ PIO_STACK_LOCATION	IrpSp
	)

Definition at line 19 of file interface.c.

{
    PAGED_CODE();

    if (IsEqualGUIDAligned(IrpSp->Parameters.QueryInterface.InterfaceType,
                           &GUID_TRANSLATOR_INTERFACE_STANDARD))
    {
        NTSTATUS Status;
        CM_RESOURCE_TYPE ResourceType;
        ULONG ParentBusType, ParentBusNumber, Dummy;

        ResourceType = PtrToUlong(IrpSp->Parameters.QueryInterface.InterfaceSpecificData);

        if (IrpSp->Parameters.QueryInterface.Size < sizeof(TRANSLATOR_INTERFACE) ||
            ResourceType != CmResourceTypeInterrupt)
        {
            return STATUS_NOT_SUPPORTED;
        }

        Status = IoGetDeviceProperty(FdoExt->Pdo,
                                     DevicePropertyLegacyBusType,
                                     sizeof(ParentBusType),
                                     &ParentBusType,
                                     &Dummy);
        if (!NT_SUCCESS(Status))
        {
            DPRINT1("BusType request failed with status 0x%08lx\n", Status);
            return Status;
        }

        Status = IoGetDeviceProperty(FdoExt->Pdo,
                                     DevicePropertyBusNumber,
                                     sizeof(ParentBusNumber),
                                     &ParentBusNumber,
                                     &Dummy);
        if (!NT_SUCCESS(Status))
        {
            DPRINT1("BusNumber request failed with status 0x%08lx\n", Status);
            return Status;
        }

        return HalGetInterruptTranslator(ParentBusType,
                                         ParentBusNumber,
                                         Isa,
                                         IrpSp->Parameters.QueryInterface.Size,
                                         IrpSp->Parameters.QueryInterface.Version,
                                         (PTRANSLATOR_INTERFACE)IrpSp->
                                         Parameters.QueryInterface.Interface,
                                         &ParentBusNumber);
    }

    return STATUS_NOT_SUPPORTED;
}

Referenced by _Dispatch_type_(), and IsaFdoPnp().

IsaHwConfigureDevice()

NTSTATUS IsaHwConfigureDevice	(	_In_ PISAPNP_FDO_EXTENSION	FdoExt,
		_In_ PISAPNP_LOGICAL_DEVICE	LogicalDevice,
		_In_ PCM_RESOURCE_LIST	Resources
	)

Definition at line 1603 of file hardware.c.

{
    UCHAR i,
          NumberOfIo = 0,
          NumberOfIrq = 0,
          NumberOfDma = 0,
          NumberOfMemory = 0;

    PAGED_CODE();

    if (!Resources)
        return STATUS_INSUFFICIENT_RESOURCES;

    /* Validate the resource list */
    for (i = 0; i < Resources->List[0].PartialResourceList.Count; i++)
    {
        PCM_PARTIAL_RESOURCE_DESCRIPTOR Descriptor =
            &Resources->List[0].PartialResourceList.PartialDescriptors[i];

        switch (Descriptor->Type)
        {
            case CmResourceTypePort:
            {
                if (++NumberOfIo > RTL_NUMBER_OF(LogicalDevice->Io))
                    return STATUS_INVALID_PARAMETER_1;

                if (!FindIoDescriptor(LogicalDevice,
                                      0,
                                      Descriptor->u.Port.Start.LowPart,
                                      Descriptor->u.Port.Start.LowPart +
                                      Descriptor->u.Port.Length - 1,
                                      NULL,
                                      NULL,
                                      NULL))
                {
                    return STATUS_RESOURCE_DATA_NOT_FOUND;
                }

                break;
            }

            case CmResourceTypeInterrupt:
            {
                if (++NumberOfIrq > RTL_NUMBER_OF(LogicalDevice->Irq))
                    return STATUS_INVALID_PARAMETER_2;

                if (!FindIrqDescriptor(LogicalDevice, Descriptor->u.Interrupt.Level, NULL))
                    return STATUS_RESOURCE_DATA_NOT_FOUND;

                break;
            }

            case CmResourceTypeDma:
            {
                if (++NumberOfDma > RTL_NUMBER_OF(LogicalDevice->Dma))
                    return STATUS_INVALID_PARAMETER_3;

                if (!FindDmaDescriptor(LogicalDevice, Descriptor->u.Dma.Channel, NULL))
                    return STATUS_RESOURCE_DATA_NOT_FOUND;

                break;
            }

            case CmResourceTypeMemory:
            {
                BOOLEAN Memory32;

                if (++NumberOfMemory > RTL_NUMBER_OF(LogicalDevice->MemRange))
                    return STATUS_INVALID_PARAMETER_4;

                if (!FindMemoryDescriptor(LogicalDevice,
                                          Descriptor->u.Memory.Start.LowPart,
                                          Descriptor->u.Memory.Start.LowPart +
                                          Descriptor->u.Memory.Length - 1,
                                          &Memory32,
                                          NULL,
                                          NULL))
                {
                    return STATUS_RESOURCE_DATA_NOT_FOUND;
                }

                if (!Memory32 && (Descriptor->u.Memory.Start.LowPart & 0xFF))
                    return STATUS_INVALID_PARAMETER;

                break;
            }

            default:
                break;
        }
    }

    WriteResources(FdoExt->ReadDataPort, LogicalDevice, &Resources->List[0].PartialResourceList);

    KeStallExecutionProcessor(10000);

    return STATUS_SUCCESS;
}

Referenced by IsaPdoPnp().

IsaHwTryReadDataPort()

UCHAR IsaHwTryReadDataPort

(

_In_ PUCHAR

ReadDataPort

)

Definition at line 1362 of file hardware.c.

{
    ULONG NumberOfRead = 0;
    UCHAR Csn = 0;

    PAGED_CODE();

    DPRINT("Setting read data port: 0x%p\n", ReadDataPort);

    SendKey();

    WriteByte(ISAPNP_CONFIGCONTROL,
              ISAPNP_CONFIG_RESET_CSN | ISAPNP_CONFIG_WAIT_FOR_KEY);
    KeStallExecutionProcessor(2000);

    SendKey();

    Wake(0x00);
    KeStallExecutionProcessor(1000);

    SetReadDataPort(ReadDataPort);

    Wake(0x00);

    while (TRUE)
    {
        ISAPNP_IDENTIFIER Identifier;
        UCHAR i, j;
        BOOLEAN Seen55aa = FALSE;

        EnterIsolationState();
        KeStallExecutionProcessor(1000);

        RtlZeroMemory(&Identifier, sizeof(Identifier));

        for (i = 0; i < sizeof(Identifier); i++)
        {
            UCHAR Byte = 0;

            for (j = 0; j < RTL_BITS_OF(Byte); j++)
            {
                USHORT Data;

                Data = ReadData(ReadDataPort) << 8;
                KeStallExecutionProcessor(250);
                Data |= ReadData(ReadDataPort);
                KeStallExecutionProcessor(250);

                Byte >>= 1;

                if (Data == 0x55AA)
                {
                    Byte |= 0x80;
                    Seen55aa = TRUE;
                }
            }

            ((PUCHAR)&Identifier)[i] = Byte;
        }

        ++NumberOfRead;

        if (Identifier.Checksum != 0x00 &&
            Identifier.Checksum != IsaPnpChecksum(&Identifier))
        {
            DPRINT("Bad checksum\n");
            break;
        }

        if (!Seen55aa)
        {
            DPRINT("Saw no sign of life\n");
            break;
        }

        Csn++;

        WriteCsn(Csn);
        KeStallExecutionProcessor(1000);

        Wake(0x00);
    }

    Wake(0x00);

    if (NumberOfRead == 1)
    {
        DPRINT("Trying next read data port\n");
        return 0;
    }
    else
    {
        DPRINT("Found %u cards at read port 0x%p\n", Csn, ReadDataPort);
        return Csn;
    }
}

Referenced by IsaPdoStartReadPort(), and IsaPnpFillDeviceRelations().

IsaPdoPnp()

NTSTATUS IsaPdoPnp	(	_In_ PISAPNP_PDO_EXTENSION	PdoDeviceExtension,
		_Inout_ PIRP	Irp,
		_In_ PIO_STACK_LOCATION	IrpSp
	)

Definition at line 864 of file pdo.c.

{
    NTSTATUS Status = Irp->IoStatus.Status;

    PAGED_CODE();

    if (PdoExt->Common.Signature == IsaPnpLogicalDevice)
    {
        DPRINT("%s(%p, %p) CSN %u, LDN %u, Minor - %X\n",
               __FUNCTION__,
               PdoExt,
               Irp,
               PdoExt->IsaPnpDevice->CSN,
               PdoExt->IsaPnpDevice->LDN,
               IrpSp->MinorFunction);
    }
    else
    {
        DPRINT("%s(%p, %p) ReadPort, Minor - %X\n",
               __FUNCTION__,
               PdoExt,
               Irp,
               IrpSp->MinorFunction);
    }

    switch (IrpSp->MinorFunction)
    {
        case IRP_MN_START_DEVICE:
        {
            if (PdoExt->Common.Signature == IsaPnpLogicalDevice)
            {
                IsaHwWakeDevice(PdoExt->IsaPnpDevice);

                Status = IsaHwConfigureDevice(PdoExt->FdoExt,
                                              PdoExt->IsaPnpDevice,
                                              IrpSp->Parameters.StartDevice.AllocatedResources);
                if (NT_SUCCESS(Status))
                {
                    IsaHwActivateDevice(PdoExt->FdoExt, PdoExt->IsaPnpDevice);
                }
                else
                {
                    DPRINT1("Failed to configure CSN %u, LDN %u with status 0x%08lx\n",
                            PdoExt->IsaPnpDevice->CSN, PdoExt->IsaPnpDevice->LDN, Status);
                }

                IsaHwWaitForKey();
            }
            else
            {
                Status = IsaPdoStartReadPort(PdoExt,
                                             IrpSp->Parameters.StartDevice.AllocatedResources);
            }

            if (NT_SUCCESS(Status))
                PdoExt->Common.State = dsStarted;
            break;
        }

        case IRP_MN_STOP_DEVICE:
        {
            if (PdoExt->Common.Signature == IsaPnpLogicalDevice)
            {
                IsaHwWakeDevice(PdoExt->IsaPnpDevice);
                IsaHwDeactivateDevice(PdoExt->IsaPnpDevice);

                IsaHwWaitForKey();
            }
            else
            {
                PdoExt->Flags &= ~ISAPNP_READ_PORT_ALLOW_FDO_SCAN;
            }

            Status = STATUS_SUCCESS;

            if (NT_SUCCESS(Status))
                PdoExt->Common.State = dsStopped;
            break;
        }

        case IRP_MN_QUERY_STOP_DEVICE:
        {
            if (PdoExt->SpecialFiles > 0)
                Status = STATUS_DEVICE_BUSY;
            else if (PdoExt->Flags & ISAPNP_READ_PORT_NEED_REBALANCE)
                Status = STATUS_RESOURCE_REQUIREMENTS_CHANGED;
            else
                Status = STATUS_SUCCESS;

            break;
        }

        case IRP_MN_QUERY_REMOVE_DEVICE:
        {
            if (PdoExt->SpecialFiles > 0)
                Status = STATUS_DEVICE_BUSY;
            else
                Status = STATUS_SUCCESS;
            break;
        }

        case IRP_MN_QUERY_DEVICE_RELATIONS:
            Status = IsaPdoQueryDeviceRelations(PdoExt, Irp, IrpSp);
            break;

        case IRP_MN_QUERY_CAPABILITIES:
            Status = IsaPdoQueryCapabilities(PdoExt, Irp, IrpSp);
            break;

        case IRP_MN_SURPRISE_REMOVAL:
            if (PdoExt->Common.Signature == IsaPnpLogicalDevice)
                Status = IsaPdoRemoveDevice(PdoExt, FALSE);
            else
                Status = IsaReadPortRemoveDevice(PdoExt, FALSE);
            break;

        case IRP_MN_REMOVE_DEVICE:
            if (PdoExt->Common.Signature == IsaPnpLogicalDevice)
                Status = IsaPdoRemoveDevice(PdoExt, TRUE);
            else
                Status = IsaReadPortRemoveDevice(PdoExt, TRUE);
            break;

        case IRP_MN_QUERY_PNP_DEVICE_STATE:
            Status = IsaPdoQueryPnpDeviceState(PdoExt, Irp);
            break;

        case IRP_MN_QUERY_RESOURCES:
            Status = IsaPdoQueryResources(PdoExt, Irp, IrpSp);
            break;

        case IRP_MN_QUERY_RESOURCE_REQUIREMENTS:
            Status = IsaPdoQueryResourceRequirements(PdoExt, Irp, IrpSp);
            break;

        case IRP_MN_QUERY_ID:
            if (PdoExt->Common.Signature == IsaPnpLogicalDevice)
                Status = IsaPdoQueryId(PdoExt, Irp, IrpSp);
            else
                Status = IsaReadPortQueryId(Irp, IrpSp);
            break;

        case IRP_MN_QUERY_DEVICE_TEXT:
            if (PdoExt->Common.Signature == IsaPnpLogicalDevice)
                Status = IsaPdoQueryDeviceText(PdoExt, Irp, IrpSp);
            break;

        case IRP_MN_FILTER_RESOURCE_REQUIREMENTS:
            Status = IsaPdoFilterResourceRequirements(PdoExt, Irp, IrpSp);
            break;

        case IRP_MN_QUERY_BUS_INFORMATION:
            Status = IsaPdoQueryBusInformation(PdoExt, Irp);
            break;

        case IRP_MN_DEVICE_USAGE_NOTIFICATION:
            Status = IsaPdoQueryDeviceUsageNotification(PdoExt, Irp, IrpSp);
            break;

        case IRP_MN_CANCEL_REMOVE_DEVICE:
        case IRP_MN_CANCEL_STOP_DEVICE:
            Status = STATUS_SUCCESS;
            break;

        default:
            DPRINT("Unknown PnP code: %X\n", IrpSp->MinorFunction);
            break;
    }

    Irp->IoStatus.Status = Status;
    IoCompleteRequest(Irp, IO_NO_INCREMENT);

    return Status;
}

Referenced by _Dispatch_type_().

IsaPnpCreateReadPortDORequirements()

NTSTATUS IsaPnpCreateReadPortDORequirements	(	_In_ PISAPNP_PDO_EXTENSION	PdoExt,
		_In_opt_ ULONG	SelectedReadPort
	)

Definition at line 1042 of file isapnp.c.

{
    ULONG ResourceCount, ListSize, i;
    PIO_RESOURCE_REQUIREMENTS_LIST RequirementsList;
    PIO_RESOURCE_DESCRIPTOR Descriptor;
    const ULONG Ports[] = { ISAPNP_WRITE_DATA, ISAPNP_ADDRESS };
    const ULONG ReadPorts[] = { 0x274, 0x3E4, 0x204, 0x2E4, 0x354, 0x2F4 };

    PAGED_CODE();

    if (SelectedReadPort)
    {
        /*
         * [IO descriptor: ISAPNP_WRITE_DATA, required]
         * [IO descriptor: ISAPNP_WRITE_DATA, optional]
         * [IO descriptor: ISAPNP_ADDRESS, required]
         * [IO descriptor: ISAPNP_ADDRESS, optional]
         * [IO descriptor: Selected Read Port, required]
         * [IO descriptor: Read Port 1, optional]
         * [IO descriptor: Read Port 2, optional]
         * [...]
         * [IO descriptor: Read Port X - 1, optional]
         */
        ResourceCount = RTL_NUMBER_OF(Ports) * 2 + RTL_NUMBER_OF(ReadPorts);
    }
    else
    {
        /*
         * [IO descriptor: ISAPNP_WRITE_DATA, required]
         * [IO descriptor: ISAPNP_WRITE_DATA, optional]
         * [IO descriptor: ISAPNP_ADDRESS, required]
         * [IO descriptor: ISAPNP_ADDRESS, optional]
         * [IO descriptor: Read Port 1, required]
         * [IO descriptor: Read Port 1, optional]
         * [IO descriptor: Read Port 2, required]
         * [IO descriptor: Read Port 2, optional]
         * [...]
         * [IO descriptor: Read Port X, required]
         * [IO descriptor: Read Port X, optional]
         */
        ResourceCount = (RTL_NUMBER_OF(Ports) + RTL_NUMBER_OF(ReadPorts)) * 2;
    }
    ListSize = sizeof(IO_RESOURCE_REQUIREMENTS_LIST) +
               sizeof(IO_RESOURCE_DESCRIPTOR) * (ResourceCount - 1);
    RequirementsList = ExAllocatePoolZero(PagedPool, ListSize, TAG_ISAPNP);
    if (!RequirementsList)
        return STATUS_NO_MEMORY;

    RequirementsList->ListSize = ListSize;
    RequirementsList->AlternativeLists = 1;

    RequirementsList->List[0].Version = 1;
    RequirementsList->List[0].Revision = 1;
    RequirementsList->List[0].Count = ResourceCount;

    Descriptor = &RequirementsList->List[0].Descriptors[0];

    /* Store the Data port and the Address port */
    for (i = 0; i < RTL_NUMBER_OF(Ports) * 2; i++)
    {
        if ((i % 2) == 0)
        {
            /* Expected port */
            Descriptor->Type = CmResourceTypePort;
            Descriptor->ShareDisposition = CmResourceShareDeviceExclusive;
            Descriptor->Flags = CM_RESOURCE_PORT_16_BIT_DECODE;
            Descriptor->u.Port.Length = 0x01;
            Descriptor->u.Port.Alignment = 0x01;
            Descriptor->u.Port.MinimumAddress.LowPart =
            Descriptor->u.Port.MaximumAddress.LowPart = Ports[i / 2];
        }
        else
        {
            /* ... but mark it as optional */
            Descriptor->Option = IO_RESOURCE_ALTERNATIVE;
            Descriptor->Type = CmResourceTypePort;
            Descriptor->ShareDisposition = CmResourceShareDeviceExclusive;
            Descriptor->Flags = CM_RESOURCE_PORT_16_BIT_DECODE;
            Descriptor->u.Port.Alignment = 0x01;
        }

        Descriptor++;
    }

    /* Store the Read Ports */
    if (SelectedReadPort)
    {
        BOOLEAN Selected = FALSE;

        DBG_UNREFERENCED_LOCAL_VARIABLE(Selected);

        for (i = 0; i < RTL_NUMBER_OF(ReadPorts); i++)
        {
            if (ReadPorts[i] != SelectedReadPort)
                Descriptor->Option = IO_RESOURCE_ALTERNATIVE;
            else
                Selected = TRUE;
            Descriptor->Type = CmResourceTypePort;
            Descriptor->ShareDisposition = CmResourceShareDeviceExclusive;
            Descriptor->Flags = CM_RESOURCE_PORT_16_BIT_DECODE;
            Descriptor->u.Port.Length = 0x04;
            Descriptor->u.Port.Alignment = 0x01;
            Descriptor->u.Port.MinimumAddress.LowPart = ReadPorts[i];
            Descriptor->u.Port.MaximumAddress.LowPart = ReadPorts[i] +
                                                        Descriptor->u.Port.Length - 1;

            Descriptor++;
        }

        ASSERT(Selected == TRUE);
    }
    else
    {
        for (i = 0; i < RTL_NUMBER_OF(ReadPorts) * 2; i++)
        {
            if ((i % 2) == 0)
            {
                /* Expected port */
                Descriptor->Type = CmResourceTypePort;
                Descriptor->ShareDisposition = CmResourceShareDeviceExclusive;
                Descriptor->Flags = CM_RESOURCE_PORT_16_BIT_DECODE;
                Descriptor->u.Port.Length = 0x04;
                Descriptor->u.Port.Alignment = 0x01;
                Descriptor->u.Port.MinimumAddress.LowPart = ReadPorts[i / 2];
                Descriptor->u.Port.MaximumAddress.LowPart = ReadPorts[i / 2] +
                                                            Descriptor->u.Port.Length - 1;
            }
            else
            {
                /* ... but mark it as optional */
                Descriptor->Option = IO_RESOURCE_ALTERNATIVE;
                Descriptor->Type = CmResourceTypePort;
                Descriptor->ShareDisposition = CmResourceShareDeviceExclusive;
                Descriptor->Flags = CM_RESOURCE_PORT_16_BIT_DECODE;
                Descriptor->u.Port.Alignment = 0x01;
            }

            Descriptor++;
        }
    }

    PdoExt->RequirementsList = RequirementsList;
    return STATUS_SUCCESS;
}

Referenced by IsaPdoStartReadPort(), and IsaPnpCreateReadPortDO().

IsaPnpFillDeviceRelations()

NTSTATUS IsaPnpFillDeviceRelations	(	_In_ PISAPNP_FDO_EXTENSION	FdoExt,
		_Inout_ PIRP	Irp,
		_In_ BOOLEAN	IncludeDataPort
	)

Definition at line 1304 of file isapnp.c.

{
    NTSTATUS Status = STATUS_SUCCESS;
    PLIST_ENTRY CurrentEntry;
    PISAPNP_LOGICAL_DEVICE IsaDevice;
    PDEVICE_RELATIONS DeviceRelations;
    ULONG PdoCount, i = 0;

    PAGED_CODE();

    IsaPnpAcquireBusDataLock();

    /* Try to claim the Read Port for our FDO */
    if (!ReadPortCreated)
    {
        Status = IsaPnpCreateReadPortDO(FdoExt);
        if (!NT_SUCCESS(Status))
            return Status;

        ReadPortCreated = TRUE;
    }

    IsaPnpReleaseBusDataLock();

    /* Inactive ISA bus */
    if (!FdoExt->ReadPortPdo)
        IncludeDataPort = FALSE;

    IsaPnpAcquireDeviceDataLock(FdoExt);

    /* If called from the FDO dispatch routine && Active bus */
    if (IncludeDataPort && FdoExt->ReadPortPdo)
    {
        PISAPNP_PDO_EXTENSION ReadPortExt = FdoExt->ReadPortPdo->DeviceExtension;

        if ((ReadPortExt->Flags & ISAPNP_READ_PORT_ALLOW_FDO_SCAN) &&
            !(ReadPortExt->Flags & ISAPNP_SCANNED_BY_READ_PORT))
        {
            DPRINT("Rescan ISA PnP bus\n");

            /* Run the isolation protocol */
            FdoExt->Cards = IsaHwTryReadDataPort(FdoExt->ReadDataPort);

            /* Card identification */
            if (FdoExt->Cards > 0)
                (VOID)IsaHwFillDeviceList(FdoExt);

            IsaHwWaitForKey();
        }

        ReadPortExt->Flags &= ~ISAPNP_SCANNED_BY_READ_PORT;
    }

    PdoCount = FdoExt->DeviceCount;
    if (IncludeDataPort)
        ++PdoCount;

    CurrentEntry = FdoExt->DeviceListHead.Flink;
    while (CurrentEntry != &FdoExt->DeviceListHead)
    {
        IsaDevice = CONTAINING_RECORD(CurrentEntry, ISAPNP_LOGICAL_DEVICE, DeviceLink);

        if (!(IsaDevice->Flags & ISAPNP_PRESENT))
            --PdoCount;

        CurrentEntry = CurrentEntry->Flink;
    }

    DeviceRelations = ExAllocatePoolWithTag(PagedPool,
                                            FIELD_OFFSET(DEVICE_RELATIONS, Objects[PdoCount]),
                                            TAG_ISAPNP);
    if (!DeviceRelations)
    {
        IsaPnpReleaseDeviceDataLock(FdoExt);
        return STATUS_NO_MEMORY;
    }

    if (IncludeDataPort)
    {
        PISAPNP_PDO_EXTENSION ReadPortExt = FdoExt->ReadPortPdo->DeviceExtension;

        DeviceRelations->Objects[i++] = FdoExt->ReadPortPdo;
        ObReferenceObject(FdoExt->ReadPortPdo);

        /* The Read Port PDO can only be removed by FDO */
        ReadPortExt->Flags |= ISAPNP_ENUMERATED;
    }

    CurrentEntry = FdoExt->DeviceListHead.Flink;
    while (CurrentEntry != &FdoExt->DeviceListHead)
    {
        PISAPNP_PDO_EXTENSION PdoExt;

        IsaDevice = CONTAINING_RECORD(CurrentEntry, ISAPNP_LOGICAL_DEVICE, DeviceLink);

        if (!(IsaDevice->Flags & ISAPNP_PRESENT))
            goto SkipPdo;

        if (!IsaDevice->Pdo)
        {
            Status = IoCreateDevice(FdoExt->DriverObject,
                                    sizeof(ISAPNP_PDO_EXTENSION),
                                    NULL,
                                    FILE_DEVICE_CONTROLLER,
                                    FILE_DEVICE_SECURE_OPEN | FILE_AUTOGENERATED_DEVICE_NAME,
                                    FALSE,
                                    &IsaDevice->Pdo);
            if (!NT_SUCCESS(Status))
                goto SkipPdo;

            IsaDevice->Pdo->Flags &= ~DO_DEVICE_INITIALIZING;
            /* The power pagable flag is always unset */

            PdoExt = IsaDevice->Pdo->DeviceExtension;

            RtlZeroMemory(PdoExt, sizeof(ISAPNP_PDO_EXTENSION));
            PdoExt->Common.Signature = IsaPnpLogicalDevice;
            PdoExt->Common.Self = IsaDevice->Pdo;
            PdoExt->Common.State = dsStopped;
            PdoExt->IsaPnpDevice = IsaDevice;
            PdoExt->FdoExt = FdoExt;

            if (!NT_SUCCESS(IsaPnpCreateLogicalDeviceRequirements(PdoExt)) ||
                !NT_SUCCESS(IsaPnpCreateLogicalDeviceResources(PdoExt)))
            {
                if (PdoExt->RequirementsList)
                {
                    ExFreePoolWithTag(PdoExt->RequirementsList, TAG_ISAPNP);
                    PdoExt->RequirementsList = NULL;
                }

                if (PdoExt->ResourceList)
                {
                    ExFreePoolWithTag(PdoExt->ResourceList, TAG_ISAPNP);
                    PdoExt->ResourceList = NULL;
                }

                IoDeleteDevice(IsaDevice->Pdo);
                IsaDevice->Pdo = NULL;
                goto SkipPdo;
            }
        }
        else
        {
            PdoExt = IsaDevice->Pdo->DeviceExtension;
        }
        DeviceRelations->Objects[i++] = IsaDevice->Pdo;
        ObReferenceObject(IsaDevice->Pdo);

        PdoExt->Flags |= ISAPNP_ENUMERATED;

        CurrentEntry = CurrentEntry->Flink;
        continue;

SkipPdo:
        if (IsaDevice->Pdo)
        {
            PdoExt = IsaDevice->Pdo->DeviceExtension;

            if (PdoExt)
                PdoExt->Flags &= ~ISAPNP_ENUMERATED;
        }

        CurrentEntry = CurrentEntry->Flink;
    }

    IsaPnpReleaseDeviceDataLock(FdoExt);

    DeviceRelations->Count = i;

    Irp->IoStatus.Information = (ULONG_PTR)DeviceRelations;

    return Status;
}

Referenced by IsaFdoQueryBusRelations(), and IsaPdoQueryDeviceRelations().

IsaPnpRemoveLogicalDeviceDO()

VOID IsaPnpRemoveLogicalDeviceDO

(

_In_ PDEVICE_OBJECT

Pdo

)

Definition at line 820 of file pdo.c.

{
    PISAPNP_PDO_EXTENSION PdoExt = Pdo->DeviceExtension;
    PISAPNP_LOGICAL_DEVICE LogDev = PdoExt->IsaPnpDevice;
    PLIST_ENTRY Entry;

    PAGED_CODE();
    ASSERT(LogDev);

    DPRINT("Removing CSN %u, LDN %u\n", LogDev->CSN, LogDev->LDN);

    if (PdoExt->RequirementsList)
        ExFreePoolWithTag(PdoExt->RequirementsList, TAG_ISAPNP);

    if (PdoExt->ResourceList)
        ExFreePoolWithTag(PdoExt->ResourceList, TAG_ISAPNP);

    if (LogDev->FriendlyName)
        ExFreePoolWithTag(LogDev->FriendlyName, TAG_ISAPNP);

    if (LogDev->Alternatives)
        ExFreePoolWithTag(LogDev->Alternatives, TAG_ISAPNP);

    Entry = LogDev->CompatibleIdList.Flink;
    while (Entry != &LogDev->CompatibleIdList)
    {
        PISAPNP_COMPATIBLE_ID_ENTRY CompatibleId =
            CONTAINING_RECORD(Entry, ISAPNP_COMPATIBLE_ID_ENTRY, IdLink);

        RemoveEntryList(&CompatibleId->IdLink);

        Entry = Entry->Flink;

        ExFreePoolWithTag(CompatibleId, TAG_ISAPNP);
    }

    ExFreePoolWithTag(LogDev, TAG_ISAPNP);

    IoDeleteDevice(PdoExt->Common.Self);
}

Referenced by IsaFdoRemoveDevice(), and IsaPdoRemoveDevice().

IsaPnpRemoveReadPortDO()

VOID IsaPnpRemoveReadPortDO

(

_In_ PDEVICE_OBJECT

Pdo

)

Definition at line 1284 of file isapnp.c.

{
    PISAPNP_PDO_EXTENSION ReadPortExt = Pdo->DeviceExtension;

    PAGED_CODE();

    DPRINT("Removing Read Port\n");

    if (ReadPortExt->RequirementsList)
        ExFreePoolWithTag(ReadPortExt->RequirementsList, TAG_ISAPNP);

    if (ReadPortExt->ResourceList)
        ExFreePoolWithTag(ReadPortExt->ResourceList, TAG_ISAPNP);

    IoDeleteDevice(Pdo);
}

Referenced by IsaFdoRemoveDevice(), IsaPnpCreateReadPortDO(), and IsaReadPortRemoveDevice().

Variable Documentation

BusSyncEvent

KEVENT BusSyncEvent

Definition at line 21 of file isapnp.c.

Referenced by _Releases_lock_(), _Requires_lock_not_held_(), and DriverEntry().

DriverEntry

DRIVER_INITIALIZE DriverEntry

Definition at line 336 of file isapnp.h.

LogicalDevice

_In_ PISAPNP_LOGICAL_DEVICE LogicalDevice

Definition at line 399 of file isapnp.h.

Referenced by _IRQL_requires_max_(), and IsaHwConfigureDevice().