agpintrf.c File Reference

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

Include dependency graph for agpintrf.c:

Go to the source code of this file.

Macros
#define	NDEBUG

Functions
static VOID NTAPI	agpintrf_Reference (_In_ PVOID Context)
static VOID NTAPI	agpintrf_Dereference (_In_ PVOID Context)
static NTSTATUS NTAPI	agpintrf_FindHostBridge (_In_ PPCI_FDO_EXTENSION FdoExtension, _Out_ PPCI_PDO_EXTENSION *HostBridge)
	Finds the one host bridge on a root bus that has an AGP capability.
NTSTATUS NTAPI	agpintrf_Initializer (IN PVOID Instance)
NTSTATUS NTAPI	agpintrf_Constructor (IN PVOID DeviceExtension, IN PVOID Instance, IN PVOID InterfaceData, IN USHORT Version, IN USHORT Size, IN PINTERFACE Interface)

Variables
PCI_INTERFACE	AgpTargetInterface

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 15 of file agpintrf.c.

Function Documentation

agpintrf_Constructor()

NTSTATUS NTAPI agpintrf_Constructor	(	IN PVOID	DeviceExtension,
		IN PVOID	Instance,
		IN PVOID	InterfaceData,
		IN USHORT	Version,
		IN USHORT	Size,
		IN PINTERFACE	Interface
	)

Definition at line 117 of file agpintrf.c.

{
    PPCI_PDO_EXTENSION PdoExtension = (PPCI_PDO_EXTENSION)DeviceExtension;
    PAGP_TARGET_BUS_INTERFACE_STANDARD AgpInterface;
    PPCI_PDO_EXTENSION Target;
    NTSTATUS Status;
 
    UNREFERENCED_PARAMETER(Instance);
    UNREFERENCED_PARAMETER(InterfaceData);
    UNREFERENCED_PARAMETER(Size);
    PAGED_CODE();
 
    /* Only AGP bridges are supported (which are PCI-to-PCI Bridge Devices) */
    if ((PdoExtension->BaseClass != PCI_CLASS_BRIDGE_DEV) ||
        (PdoExtension->SubClass != PCI_SUBCLASS_BR_PCI_TO_PCI))
    {
        /* Fail any other PDO */
        return STATUS_NOT_SUPPORTED;
    }
 
    /* Without its own target capability the bridge relies on a host bridge beside it */
    Target = PdoExtension;
    if (!PdoExtension->TargetAgpCapabilityId)
    {
        if (!PCI_IS_ROOT_FDO(PdoExtension->ParentFdoExtension))
            return STATUS_NOT_SUPPORTED;
 
        Status = agpintrf_FindHostBridge(PdoExtension->ParentFdoExtension, &Target);
        if (!NT_SUCCESS(Status))
            return Status;
    }
 
    AgpInterface = (PAGP_TARGET_BUS_INTERFACE_STANDARD)Interface;
    AgpInterface->Size = sizeof(*AgpInterface);
    AgpInterface->Version = Version;
    AgpInterface->Context = Target;
    AgpInterface->InterfaceReference = agpintrf_Reference;
    AgpInterface->InterfaceDereference = agpintrf_Dereference;
    AgpInterface->SetBusData = PciBusInterface_SetBusData;
    AgpInterface->GetBusData = PciBusInterface_GetBusData;
    AgpInterface->CapabilityID = Target->TargetAgpCapabilityId;
 
    return STATUS_SUCCESS;
}

agpintrf_Dereference()

static VOID NTAPI agpintrf_Dereference ( _In_ PVOID  Context )

static

Definition at line 50 of file agpintrf.c.

{
    PPCI_PDO_EXTENSION PdoExtension = (PPCI_PDO_EXTENSION)Context;
 
    ObDereferenceObject(PdoExtension->PhysicalDeviceObject);
    InterlockedDecrement(&PdoExtension->AgpInterfaceReferenceCount);
}

Referenced by agpintrf_Constructor().

agpintrf_FindHostBridge()

static NTSTATUS NTAPI agpintrf_FindHostBridge ( _In_ PPCI_FDO_EXTENSION  FdoExtension, _Out_ PPCI_PDO_EXTENSION *  HostBridge  )

static

Finds the one host bridge on a root bus that has an AGP capability.

Definition at line 65 of file agpintrf.c.

{
    PPCI_PDO_EXTENSION Child;
    PPCI_PDO_EXTENSION Found = NULL;
    NTSTATUS Status = STATUS_NO_SUCH_DEVICE;
    PAGED_CODE();
 
    KeEnterCriticalRegion();
    KeWaitForSingleObject(&FdoExtension->ChildListLock, Executive, KernelMode, FALSE, NULL);
 
    for (Child = FdoExtension->ChildPdoList; Child; Child = Child->Next)
    {
        if ((Child->BaseClass != PCI_CLASS_BRIDGE_DEV) ||
            (Child->SubClass != PCI_SUBCLASS_BR_HOST) ||
            !Child->TargetAgpCapabilityId)
        {
            continue;
        }
 
        /* More than one candidate leaves no way to pick the right one */
        if (Found)
        {
            Found = NULL;
            Status = STATUS_NOT_SUPPORTED;
            break;
        }
 
        Found = Child;
        Status = STATUS_SUCCESS;
    }
 
    KeSetEvent(&FdoExtension->ChildListLock, IO_NO_INCREMENT, FALSE);
    KeLeaveCriticalRegion();
 
    *HostBridge = Found;
    return Status;
}

Referenced by agpintrf_Constructor().

agpintrf_Initializer()

NTSTATUS NTAPI agpintrf_Initializer

(

IN PVOID

Instance

)

Definition at line 107 of file agpintrf.c.

{
    UNREFERENCED_PARAMETER(Instance);
    /* PnP Interfaces don't get Initialized */
    ASSERTMSG("PCI agpintrf_Initializer, unexpected call.\n", FALSE);
    return STATUS_UNSUCCESSFUL;
}

agpintrf_Reference()

static VOID NTAPI agpintrf_Reference ( _In_ PVOID  Context )

static

Definition at line 38 of file agpintrf.c.

{
    PPCI_PDO_EXTENSION PdoExtension = (PPCI_PDO_EXTENSION)Context;
 
    InterlockedIncrement(&PdoExtension->AgpInterfaceReferenceCount);
    ObReferenceObject(PdoExtension->PhysicalDeviceObject);
}

Referenced by agpintrf_Constructor().

Variable Documentation

AgpTargetInterface

PCI_INTERFACE AgpTargetInterface

Initial value:

=
{
    &GUID_AGP_TARGET_BUS_INTERFACE_STANDARD,
    sizeof(AGP_TARGET_BUS_INTERFACE_STANDARD),
    AGP_BUS_INTERFACE_V1,
    AGP_BUS_INTERFACE_V1,
    PCI_INTERFACE_PDO,
    0,
    PciInterface_AgpTarget,
    agpintrf_Constructor,
    agpintrf_Initializer
}

Definition at line 20 of file agpintrf.c.