arbirq.c File Reference

#include <ntoskrnl.h>
#include <debug.h>

Include dependency graph for arbirq.c:

Go to the source code of this file.

Macros
#define	NDEBUG

Functions
NTSTATUS NTAPI	IopArbIrqUnpackRequirements (_In_ PIO_RESOURCE_DESCRIPTOR IoDescriptor, _Out_ PUINT64 OutMinimumAddress, _Out_ PUINT64 OutMaximumAddress, _Out_ PUINT64 OutLength, _Out_ PUINT64 OutAlignment)
NTSTATUS NTAPI	IopArbIrqPackResource (_In_ PIO_RESOURCE_DESCRIPTOR IoDescriptor, _In_ UINT64 Start, _Out_ PCM_PARTIAL_RESOURCE_DESCRIPTOR CmDescriptor)
NTSTATUS NTAPI	IopArbIrqUnpackResource (_In_ PCM_PARTIAL_RESOURCE_DESCRIPTOR CmDescriptor, _Out_ PUINT64 Start, _Out_ PUINT64 OutLength)
INT32 NTAPI	IopArbIrqScoreRequirement (_In_ PIO_RESOURCE_DESCRIPTOR IoDescriptor)
NTSTATUS NTAPI	IopArbIrqTranslateOrdering (_Out_ PIO_RESOURCE_DESCRIPTOR OutIoDescriptor, _In_ PIO_RESOURCE_DESCRIPTOR IoDescriptor)
NTSTATUS NTAPI	IopArbIrqInitialize (VOID)
	Initialize the root IRQ arbiter.

Variables
ARBITER_INSTANCE	IopRootIrqArbiter

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 11 of file arbirq.c.

Function Documentation

IopArbIrqInitialize()

NTSTATUS NTAPI IopArbIrqInitialize

(

VOID

)

Initialize the root IRQ arbiter.

This is the fallback that sits at the top of the tree and takes over when no closer arbiter claims the request, e.g root-enumerated / HAL legacy devices (ISA-style, directly under the root), and platforms or boot paths where no bus driver above the device provides an interrupt arbiter (e.g. no ACPI _PRT routing in effect).

In those cases the arbitrated "vectors" are the legacy ISA IRQ lines, which is why IopArbIrqTranslateOrdering maps the ordering table through HalGetInterruptVector for the ISA bus. Otherwise, such devices would have nowhere to arbitrate their interrupts. (So this is purely for legacy PIC + No ACPI)

Returns

NTSTATUS

Return values

STATUS_SUCCESS
STATUS_UNSUCCESSFUL
STATUS_INSUFFICIENT_RESOURCES

Definition at line 149 of file arbirq.c.

{
    NTSTATUS Status;
 
    PAGED_CODE();
 
    IopRootIrqArbiter.Name = L"RootIRQ";
    IopRootIrqArbiter.UnpackRequirement = IopArbIrqUnpackRequirements;
    IopRootIrqArbiter.PackResource = IopArbIrqPackResource;
    IopRootIrqArbiter.UnpackResource = IopArbIrqUnpackResource;
    IopRootIrqArbiter.ScoreRequirement = IopArbIrqScoreRequirement;
 
    Status = ArbiterLibInitializeInstance(&IopRootIrqArbiter,
                                          NULL,
                                          CmResourceTypeInterrupt,
                                          IopRootIrqArbiter.Name,
                                          L"Root",
                                          IopArbIrqTranslateOrdering);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("IopArbIrqInitialize: Failed with %X\n", Status);
    }
 
    return Status;
}

Referenced by IopInitializeArbiters().

IopArbIrqPackResource()

NTSTATUS NTAPI IopArbIrqPackResource	(	_In_ PIO_RESOURCE_DESCRIPTOR	IoDescriptor,
		_In_ UINT64	Start,
		_Out_ PCM_PARTIAL_RESOURCE_DESCRIPTOR	CmDescriptor
	)

Definition at line 41 of file arbirq.c.

{
    PAGED_CODE();
 
    CmDescriptor->Type = CmResourceTypeInterrupt;
    CmDescriptor->ShareDisposition = IoDescriptor->ShareDisposition;
    CmDescriptor->Flags = IoDescriptor->Flags;
 
    CmDescriptor->u.Interrupt.Level = (ULONG)Start;
    CmDescriptor->u.Interrupt.Vector = (ULONG)Start;
    CmDescriptor->u.Interrupt.Affinity = (KAFFINITY)-1;
 
    return STATUS_SUCCESS;
}

Referenced by IopArbIrqInitialize().

IopArbIrqScoreRequirement()

INT32 NTAPI IopArbIrqScoreRequirement

(

_In_ PIO_RESOURCE_DESCRIPTOR

IoDescriptor

)

Definition at line 76 of file arbirq.c.

{
    PAGED_CODE();
 
    return (INT32)(IoDescriptor->u.Interrupt.MaximumVector -
                   IoDescriptor->u.Interrupt.MinimumVector + 1);
}

Referenced by IopArbIrqInitialize().

IopArbIrqTranslateOrdering()

NTSTATUS NTAPI IopArbIrqTranslateOrdering	(	_Out_ PIO_RESOURCE_DESCRIPTOR	OutIoDescriptor,
		_In_ PIO_RESOURCE_DESCRIPTOR	IoDescriptor
	)

Definition at line 87 of file arbirq.c.

{
    KIRQL Irql;
    KAFFINITY Affinity = 0;
 
    PAGED_CODE();
 
    *OutIoDescriptor = *IoDescriptor;
 
    if (IoDescriptor->Type != CmResourceTypeInterrupt)
        return STATUS_SUCCESS;
 
    OutIoDescriptor->u.Interrupt.MinimumVector =
        HalGetInterruptVector(Isa,
                              0,
                              IoDescriptor->u.Interrupt.MinimumVector,
                              IoDescriptor->u.Interrupt.MinimumVector,
                              &Irql,
                              &Affinity);
 
    if (Affinity != 0)
    {
        Affinity = 0;
        OutIoDescriptor->u.Interrupt.MaximumVector =
            HalGetInterruptVector(Isa,
                                  0,
                                  IoDescriptor->u.Interrupt.MaximumVector,
                                  IoDescriptor->u.Interrupt.MaximumVector,
                                  &Irql,
                                  &Affinity);
    }
 
    if (Affinity == 0)
        *OutIoDescriptor = *IoDescriptor;
 
    return STATUS_SUCCESS;
}

Referenced by IopArbIrqInitialize().

IopArbIrqUnpackRequirements()

NTSTATUS NTAPI IopArbIrqUnpackRequirements	(	_In_ PIO_RESOURCE_DESCRIPTOR	IoDescriptor,
		_Out_ PUINT64	OutMinimumAddress,
		_Out_ PUINT64	OutMaximumAddress,
		_Out_ PUINT64	OutLength,
		_Out_ PUINT64	OutAlignment
	)

Definition at line 22 of file arbirq.c.

{
    PAGED_CODE();
 
    *OutMinimumAddress = IoDescriptor->u.Interrupt.MinimumVector;
    *OutMaximumAddress = IoDescriptor->u.Interrupt.MaximumVector;
    *OutLength = 1;
    *OutAlignment = 1;
 
    return STATUS_SUCCESS;
}

Referenced by IopArbIrqInitialize().

IopArbIrqUnpackResource()

NTSTATUS NTAPI IopArbIrqUnpackResource	(	_In_ PCM_PARTIAL_RESOURCE_DESCRIPTOR	CmDescriptor,
		_Out_ PUINT64	Start,
		_Out_ PUINT64	OutLength
	)

Definition at line 61 of file arbirq.c.

{
    PAGED_CODE();
 
    *Start = CmDescriptor->u.Interrupt.Vector;
    *OutLength = 1;
 
    return STATUS_SUCCESS;
}

Referenced by IopArbIrqInitialize().

Variable Documentation

IopRootIrqArbiter

ARBITER_INSTANCE IopRootIrqArbiter

extern

Definition at line 24 of file pnpinit.c.

Referenced by IopArbIrqInitialize().