ar_memio.c File Reference

#include <pci.h>
#include <debug.h>

Include dependency graph for ar_memio.c:

Go to the source code of this file.

Macros
#define	NDEBUG

Functions
NTSTATUS NTAPI	ario_UnpackRequirement (_In_ PIO_RESOURCE_DESCRIPTOR Descriptor, _Out_ PULONGLONG Minimum, _Out_ PULONGLONG Maximum, _Out_ PULONGLONG Length, _Out_ PULONGLONG Alignment)
NTSTATUS NTAPI	ario_PackResource (_In_ PIO_RESOURCE_DESCRIPTOR Descriptor, _In_ ULONGLONG Start, _Out_ PCM_PARTIAL_RESOURCE_DESCRIPTOR Resource)
NTSTATUS NTAPI	ario_UnpackResource (_In_ PCM_PARTIAL_RESOURCE_DESCRIPTOR Resource, _Out_ PULONGLONG Start, _Out_ PULONGLONG Length)
INT32 NTAPI	ario_ScoreRequirement (_In_ PIO_RESOURCE_DESCRIPTOR Descriptor)
NTSTATUS NTAPI	ario_Initializer (IN PVOID Instance)
NTSTATUS NTAPI	ario_Constructor (IN PVOID DeviceExtension, IN PVOID PciInterface, IN PVOID InterfaceData, IN USHORT Version, IN USHORT Size, IN PINTERFACE Interface)
VOID NTAPI	ario_ApplyBrokenVideoHack (IN PPCI_FDO_EXTENSION FdoExtension)
NTSTATUS NTAPI	armem_UnpackRequirement (_In_ PIO_RESOURCE_DESCRIPTOR Descriptor, _Out_ PULONGLONG Minimum, _Out_ PULONGLONG Maximum, _Out_ PULONGLONG Length, _Out_ PULONGLONG Alignment)
NTSTATUS NTAPI	armem_PackResource (_In_ PIO_RESOURCE_DESCRIPTOR Descriptor, _In_ ULONGLONG Start, _Out_ PCM_PARTIAL_RESOURCE_DESCRIPTOR Resource)
NTSTATUS NTAPI	armem_UnpackResource (_In_ PCM_PARTIAL_RESOURCE_DESCRIPTOR Resource, _Out_ PULONGLONG Start, _Out_ PULONGLONG Length)
INT32 NTAPI	armem_ScoreRequirement (_In_ PIO_RESOURCE_DESCRIPTOR Descriptor)
NTSTATUS NTAPI	armem_Initializer (IN PVOID Instance)
NTSTATUS NTAPI	armem_Constructor (IN PVOID DeviceExtension, IN PVOID PciInterface, IN PVOID InterfaceData, IN USHORT Version, IN USHORT Size, IN PINTERFACE Interface)

Variables
PCI_INTERFACE	ArbiterInterfaceMemory
PCI_INTERFACE	ArbiterInterfaceIo

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 13 of file ar_memio.c.

Function Documentation

ario_ApplyBrokenVideoHack()

VOID NTAPI ario_ApplyBrokenVideoHack

(

IN PPCI_FDO_EXTENSION

FdoExtension

)

Definition at line 184 of file ar_memio.c.

{
    PPCI_ARBITER_INSTANCE PciArbiter;
    PARBITER_INSTANCE CommonInstance;
    NTSTATUS Status;
 
    /* Only valid for root FDOs who are being applied the hack for the first time */
    ASSERT(!FdoExtension->BrokenVideoHackApplied);
    ASSERT(PCI_IS_ROOT_FDO(FdoExtension));
 
    /* Find the I/O arbiter */
    PciArbiter = (PVOID)PciFindNextSecondaryExtension(FdoExtension->
                                                      SecondaryExtension.Next,
                                                      PciArb_Io);
    ASSERT(PciArbiter);
    if (!PciArbiter) return;
 
    /* Get the Arb instance */
    CommonInstance = &PciArbiter->CommonInstance;
 
    /* Free the two lists, enabling full VGA access */
    ArbiterLibFreeOrderingList(&CommonInstance->OrderingList);
    ArbiterLibFreeOrderingList(&CommonInstance->ReservedList);
 
    /* Build the ordering for broken video PCI access */
    Status = ArbiterLibDefaultAssignmentOrdering(CommonInstance,
                                                 L"Pci",
                                                 L"BrokenVideo",
                                                 NULL);
    ASSERT(NT_SUCCESS(Status));
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("PCIX - ario_ApplyBrokenVideoHack: ordering failed %X\n", Status);
    }
 
    /* Now the hack has been applied */
    FdoExtension->BrokenVideoHackApplied = TRUE;
}

Referenced by PciApplyHacks().

ario_Constructor()

NTSTATUS NTAPI ario_Constructor	(	IN PVOID	DeviceExtension,
		IN PVOID	PciInterface,
		IN PVOID	InterfaceData,
		IN USHORT	Version,
		IN USHORT	Size,
		IN PINTERFACE	Interface
	)

Definition at line 156 of file ar_memio.c.

{
    PPCI_FDO_EXTENSION FdoExtension = (PPCI_FDO_EXTENSION)DeviceExtension;
    PAGED_CODE();
 
    UNREFERENCED_PARAMETER(PciInterface);
    UNREFERENCED_PARAMETER(Version);
    UNREFERENCED_PARAMETER(Size);
 
    /* This one only arbitrates I/O ports */
    if ((ULONG_PTR)InterfaceData != CmResourceTypePort)
    {
        return STATUS_INVALID_PARAMETER_5;
    }
 
    /* Hand out the instance that was built for this bus */
    return PciArbiterConstructor(FdoExtension,
                                 PciArb_Io,
                                 (PARBITER_INTERFACE)Interface);
}

ario_Initializer()

NTSTATUS NTAPI ario_Initializer

(

IN PVOID

Instance

)

Definition at line 119 of file ar_memio.c.

{
    PPCI_ARBITER_INSTANCE Arbiter = Instance;
    PPCI_FDO_EXTENSION FdoExtension;
    NTSTATUS Status;
    PAGED_CODE();
 
    /* Start from a clean engine instance */
    RtlZeroMemory(&Arbiter->CommonInstance, sizeof(Arbiter->CommonInstance));
    FdoExtension = Arbiter->BusFdoExtension;
 
    /* Teach the engine how to read and write I/O port descriptors */
    Arbiter->CommonInstance.UnpackRequirement = ario_UnpackRequirement;
    Arbiter->CommonInstance.PackResource = ario_PackResource;
    Arbiter->CommonInstance.UnpackResource = ario_UnpackResource;
    Arbiter->CommonInstance.ScoreRequirement = ario_ScoreRequirement;
    Arbiter->CommonInstance.PreprocessEntry = PciArbiter_PreprocessEntry;
    Arbiter->CommonInstance.FindSuitableRange = PciArbiter_FindSuitableRange;
    Arbiter->CommonInstance.OverrideConflict = PciArbiter_OverrideConflict;
 
    /* The rest of the engine, and the PCI assignment ordering, is generic */
    Status = ArbiterLibInitializeInstance(&Arbiter->CommonInstance,
                                          FdoExtension->FunctionalDeviceObject,
                                          CmResourceTypePort,
                                          Arbiter->InstanceName,
                                          L"Pci",
                                          NULL);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("PCIX - ario_Initializer: init arbiter returned %X\n", Status);
    }
 
    return Status;
}

ario_PackResource()

NTSTATUS NTAPI ario_PackResource	(	_In_ PIO_RESOURCE_DESCRIPTOR	Descriptor,
		_In_ ULONGLONG	Start,
		_Out_ PCM_PARTIAL_RESOURCE_DESCRIPTOR	Resource
	)

Definition at line 67 of file ar_memio.c.

{
    /* Turn the placement the engine settled on back into an I/O port resource */
    if (Descriptor->Type != CmResourceTypePort) return STATUS_INVALID_PARAMETER;
 
    Resource->Type = CmResourceTypePort;
    Resource->Flags = Descriptor->Flags;
    Resource->ShareDisposition = Descriptor->ShareDisposition;
    Resource->u.Port.Start.QuadPart = (LONGLONG)Start;
    Resource->u.Port.Length = Descriptor->u.Port.Length;
    return STATUS_SUCCESS;
}

Referenced by ario_Initializer().

ario_ScoreRequirement()

INT32 NTAPI ario_ScoreRequirement

(

_In_ PIO_RESOURCE_DESCRIPTOR

Descriptor

)

Definition at line 98 of file ar_memio.c.

{
    ULONGLONG Minimum, Maximum, Length, Alignment;
 
    /* A requirement this arbiter cannot read is treated as unsatisfiable */
    if (!NT_SUCCESS(ario_UnpackRequirement(Descriptor,
                                           &Minimum,
                                           &Maximum,
                                           &Length,
                                           &Alignment)) ||
        (Maximum < Minimum))
    {
        return -1;
    }
 
    if ((Maximum - Minimum) >= MAXLONG) return MAXLONG;
    return (INT32)(Maximum - Minimum + 1);
}

Referenced by ario_Initializer().

ario_UnpackRequirement()

NTSTATUS NTAPI ario_UnpackRequirement	(	_In_ PIO_RESOURCE_DESCRIPTOR	Descriptor,
		_Out_ PULONGLONG	Minimum,
		_Out_ PULONGLONG	Maximum,
		_Out_ PULONGLONG	Length,
		_Out_ PULONGLONG	Alignment
	)

Definition at line 48 of file ar_memio.c.

{
    /* This arbiter is only ever handed I/O port descriptors */
    if (Descriptor->Type != CmResourceTypePort) return STATUS_INVALID_PARAMETER;
 
    /* An alignment of zero would place the range nowhere, so make it one byte */
    *Minimum = (ULONGLONG)Descriptor->u.Port.MinimumAddress.QuadPart;
    *Maximum = (ULONGLONG)Descriptor->u.Port.MaximumAddress.QuadPart;
    *Length = Descriptor->u.Port.Length;
    *Alignment = Descriptor->u.Port.Alignment ? Descriptor->u.Port.Alignment : 1;
    return STATUS_SUCCESS;
}

Referenced by ario_Initializer(), and ario_ScoreRequirement().

ario_UnpackResource()

NTSTATUS NTAPI ario_UnpackResource	(	_In_ PCM_PARTIAL_RESOURCE_DESCRIPTOR	Resource,
		_Out_ PULONGLONG	Start,
		_Out_ PULONGLONG	Length
	)

Definition at line 84 of file ar_memio.c.

{
    /* Read a previously packed I/O port resource back out */
    if (Resource->Type != CmResourceTypePort) return STATUS_INVALID_PARAMETER;
 
    *Start = (ULONGLONG)Resource->u.Port.Start.QuadPart;
    *Length = Resource->u.Port.Length;
    return STATUS_SUCCESS;
}

Referenced by ario_Initializer().

armem_Constructor()

NTSTATUS NTAPI armem_Constructor	(	IN PVOID	DeviceExtension,
		IN PVOID	PciInterface,
		IN PVOID	InterfaceData,
		IN USHORT	Version,
		IN USHORT	Size,
		IN PINTERFACE	Interface
	)

Definition at line 345 of file ar_memio.c.

{
    PPCI_FDO_EXTENSION FdoExtension = (PPCI_FDO_EXTENSION)DeviceExtension;
    PAGED_CODE();
 
    UNREFERENCED_PARAMETER(PciInterface);
    UNREFERENCED_PARAMETER(Version);
    UNREFERENCED_PARAMETER(Size);
 
    /* This one only arbitrates device memory */
    if ((ULONG_PTR)InterfaceData != CmResourceTypeMemory)
    {
        return STATUS_INVALID_PARAMETER_5;
    }
 
    /* Hand out the instance that was built for this bus */
    return PciArbiterConstructor(FdoExtension,
                                 PciArb_Memory,
                                 (PARBITER_INTERFACE)Interface);
}

armem_Initializer()

NTSTATUS NTAPI armem_Initializer

(

IN PVOID

Instance

)

Definition at line 308 of file ar_memio.c.

{
    PPCI_ARBITER_INSTANCE Arbiter = Instance;
    PPCI_FDO_EXTENSION FdoExtension;
    NTSTATUS Status;
    PAGED_CODE();
 
    /* Start from a clean engine instance */
    RtlZeroMemory(&Arbiter->CommonInstance, sizeof(Arbiter->CommonInstance));
    FdoExtension = Arbiter->BusFdoExtension;
 
    /* Teach the engine how to read and write memory descriptors */
    Arbiter->CommonInstance.UnpackRequirement = armem_UnpackRequirement;
    Arbiter->CommonInstance.PackResource = armem_PackResource;
    Arbiter->CommonInstance.UnpackResource = armem_UnpackResource;
    Arbiter->CommonInstance.ScoreRequirement = armem_ScoreRequirement;
    Arbiter->CommonInstance.PreprocessEntry = PciArbiter_PreprocessEntry;
    Arbiter->CommonInstance.FindSuitableRange = PciArbiter_FindSuitableRange;
    Arbiter->CommonInstance.OverrideConflict = PciArbiter_OverrideConflict;
 
    /* The rest of the engine, and the PCI assignment ordering, is generic */
    Status = ArbiterLibInitializeInstance(&Arbiter->CommonInstance,
                                          FdoExtension->FunctionalDeviceObject,
                                          CmResourceTypeMemory,
                                          Arbiter->InstanceName,
                                          L"Pci",
                                          NULL);
    if (!NT_SUCCESS(Status))
    {
        DPRINT1("PCIX - armem_Initializer: init arbiter returned %X\n", Status);
    }
 
    return Status;
}

armem_PackResource()

NTSTATUS NTAPI armem_PackResource	(	_In_ PIO_RESOURCE_DESCRIPTOR	Descriptor,
		_In_ ULONGLONG	Start,
		_Out_ PCM_PARTIAL_RESOURCE_DESCRIPTOR	Resource
	)

Definition at line 248 of file ar_memio.c.

{
    /* Turn the placement the engine settled on back into a memory resource */
    if ((Descriptor->Type != CmResourceTypeMemory) &&
        (Descriptor->Type != CmResourceTypeMemoryLarge))
    {
        return STATUS_INVALID_PARAMETER;
    }
 
    /* The flags say how a large length is scaled, so both come across unchanged */
    Resource->Type = Descriptor->Type;
    Resource->Flags = Descriptor->Flags;
    Resource->ShareDisposition = Descriptor->ShareDisposition;
    Resource->u.Memory.Start.QuadPart = (LONGLONG)Start;
    Resource->u.Memory.Length = Descriptor->u.Memory.Length;
    return STATUS_SUCCESS;
}

Referenced by armem_Initializer().

armem_ScoreRequirement()

INT32 NTAPI armem_ScoreRequirement

(

_In_ PIO_RESOURCE_DESCRIPTOR

Descriptor

)

Definition at line 287 of file ar_memio.c.

{
    ULONGLONG Minimum, Maximum, Length, Alignment;
 
    /* A requirement this arbiter cannot read is treated as unsatisfiable */
    if (!NT_SUCCESS(armem_UnpackRequirement(Descriptor,
                                            &Minimum,
                                            &Maximum,
                                            &Length,
                                            &Alignment)) ||
        (Maximum < Minimum))
    {
        return -1;
    }
 
    if ((Maximum - Minimum) >= MAXLONG) return MAXLONG;
    return (INT32)(Maximum - Minimum + 1);
}

Referenced by armem_Initializer().

armem_UnpackRequirement()

NTSTATUS NTAPI armem_UnpackRequirement	(	_In_ PIO_RESOURCE_DESCRIPTOR	Descriptor,
		_Out_ PULONGLONG	Minimum,
		_Out_ PULONGLONG	Maximum,
		_Out_ PULONGLONG	Length,
		_Out_ PULONGLONG	Alignment
	)

Definition at line 225 of file ar_memio.c.

{
    /* This arbiter is only ever handed device memory descriptors, large ones included */
    if ((Descriptor->Type != CmResourceTypeMemory) &&
        (Descriptor->Type != CmResourceTypeMemoryLarge))
    {
        return STATUS_INVALID_PARAMETER;
    }
 
    /* An alignment of zero would place the range nowhere, so make it one byte */
    *Length = RtlIoDecodeMemIoResource(Descriptor, Alignment, Minimum, Maximum);
    if (!*Alignment)
        *Alignment = 1;
 
    return STATUS_SUCCESS;
}

Referenced by armem_Initializer(), and armem_ScoreRequirement().

armem_UnpackResource()

NTSTATUS NTAPI armem_UnpackResource	(	_In_ PCM_PARTIAL_RESOURCE_DESCRIPTOR	Resource,
		_Out_ PULONGLONG	Start,
		_Out_ PULONGLONG	Length
	)

Definition at line 270 of file ar_memio.c.

{
    /* Read a previously packed memory resource back out */
    if ((Resource->Type != CmResourceTypeMemory) &&
        (Resource->Type != CmResourceTypeMemoryLarge))
    {
        return STATUS_INVALID_PARAMETER;
    }
 
    *Length = RtlCmDecodeMemIoResource(Resource, Start);
    return STATUS_SUCCESS;
}

Referenced by armem_Initializer().

Variable Documentation

ArbiterInterfaceIo

PCI_INTERFACE ArbiterInterfaceIo

Initial value:

=
{
    &GUID_ARBITER_INTERFACE_STANDARD,
    sizeof(ARBITER_INTERFACE),
    0,
    0,
    PCI_INTERFACE_FDO,
    0,
    PciArb_Io,
    ario_Constructor,
    ario_Initializer
}

Definition at line 31 of file ar_memio.c.

ArbiterInterfaceMemory

PCI_INTERFACE ArbiterInterfaceMemory

Initial value:

=
{
    &GUID_ARBITER_INTERFACE_STANDARD,
    sizeof(ARBITER_INTERFACE),
    0,
    0,
    PCI_INTERFACE_FDO,
    0,
    PciArb_Memory,
    armem_Constructor,
    armem_Initializer
}

Definition at line 18 of file ar_memio.c.