locintrf.c File Reference

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

Include dependency graph for locintrf.c:

Go to the source code of this file.

Macros
#define	NDEBUG

Functions
NTSTATUS NTAPI	locintrf_Initializer (IN PVOID Instance)
static VOID NTAPI	locintrf_Reference (_In_ PVOID Context)
static VOID NTAPI	locintrf_Dereference (_In_ PVOID Context)
static NTSTATUS NTAPI	locintrf_GetLocationString (_In_ PVOID Context, _Outptr_ PZZWSTR *LocationStrings)
	Returns "PCI(DDFF)" for a device or "PCIROOT(B)" for a root bus as a multi-sz. The caller frees the buffer.
NTSTATUS NTAPI	locintrf_Constructor (IN PVOID DeviceExtension, IN PVOID Instance, IN PVOID InterfaceData, IN USHORT Version, IN USHORT Size, IN PINTERFACE Interface)

Variables
PCI_INTERFACE	PciLocationInterface

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 13 of file locintrf.c.

Function Documentation

locintrf_Constructor()

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

Definition at line 116 of file locintrf.c.

{
    PPNP_LOCATION_INTERFACE LocationInterface = (PPNP_LOCATION_INTERFACE)Interface;
    PAGED_CODE();
 
    UNREFERENCED_PARAMETER(Instance);
    UNREFERENCED_PARAMETER(InterfaceData);
    UNREFERENCED_PARAMETER(Version);
    UNREFERENCED_PARAMETER(Size);
 
    LocationInterface->Size = sizeof(*LocationInterface);
    LocationInterface->Version = PNP_LOCATION_INTERFACE_VERSION;
    LocationInterface->Context = DeviceExtension;
    LocationInterface->InterfaceReference = locintrf_Reference;
    LocationInterface->InterfaceDereference = locintrf_Dereference;
    LocationInterface->GetLocationString = locintrf_GetLocationString;
    return STATUS_SUCCESS;
}

locintrf_Dereference()

static VOID NTAPI locintrf_Dereference ( _In_ PVOID  Context )

static

Definition at line 56 of file locintrf.c.

{
    UNREFERENCED_PARAMETER(Context);
}

Referenced by locintrf_Constructor().

locintrf_GetLocationString()

static NTSTATUS NTAPI locintrf_GetLocationString ( _In_ PVOID  Context, _Outptr_ PZZWSTR *  LocationStrings  )

static

Returns "PCI(DDFF)" for a device or "PCIROOT(B)" for a root bus as a multi-sz. The caller frees the buffer.

Definition at line 69 of file locintrf.c.

{
    PPCI_PDO_EXTENSION PdoExtension = Context;
    PPCI_FDO_EXTENSION FdoExtension = Context;
    BOOLEAN IsDevice;
    PWCHAR Buffer;
    SIZE_T Size;
    NTSTATUS Status;
    PAGED_CODE();
 
    *LocationStrings = NULL;
 
    IsDevice = (PdoExtension->ExtensionType == PciPdoExtensionType);
    if (!IsDevice && !PCI_IS_ROOT_FDO(FdoExtension))
        return STATUS_INVALID_PARAMETER;
 
    /* Room for the longer form plus the empty character that ends the list */
    Size = sizeof(L"PCIROOT(FF)") + sizeof(UNICODE_NULL);
    Buffer = ExAllocatePoolWithTag(PagedPool, Size, PCI_POOL_TAG);
    if (!Buffer)
        return STATUS_INSUFFICIENT_RESOURCES;
 
    RtlZeroMemory(Buffer, Size);
 
    if (IsDevice)
    {
        _swprintf(Buffer,
                  L"PCI(%02X%02X)",
                  PdoExtension->Slot.u.bits.DeviceNumber,
                  PdoExtension->Slot.u.bits.FunctionNumber);
        Status = STATUS_SUCCESS;
    }
    else
    {
        /* The root starts the path, so PnP stops asking further up */
        _swprintf(Buffer, L"PCIROOT(%X)", FdoExtension->BaseBus);
        Status = STATUS_TRANSLATION_COMPLETE;
    }
 
    *LocationStrings = Buffer;
    return Status;
}

Referenced by locintrf_Constructor().

locintrf_Initializer()

NTSTATUS NTAPI locintrf_Initializer

(

IN PVOID

Instance

)

Definition at line 35 of file locintrf.c.

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

locintrf_Reference()

static VOID NTAPI locintrf_Reference ( _In_ PVOID  Context )

static

Definition at line 46 of file locintrf.c.

{
    /* Extensions live as long as their device objects, nothing to count */
    UNREFERENCED_PARAMETER(Context);
}

Referenced by locintrf_Constructor().

Variable Documentation

PciLocationInterface

PCI_INTERFACE PciLocationInterface

Initial value:

=
{
    &GUID_PNP_LOCATION_INTERFACE,
    sizeof(PNP_LOCATION_INTERFACE),
    PNP_LOCATION_INTERFACE_VERSION,
    PNP_LOCATION_INTERFACE_VERSION,
    PCI_INTERFACE_FDO | PCI_INTERFACE_ROOT | PCI_INTERFACE_PDO,
    0,
    PciInterface_Location,
    locintrf_Constructor,
    locintrf_Initializer
}

Definition at line 18 of file locintrf.c.