ADM-XRC SDK 2.8.1 User Guide (Linux)
© Copyright 2001-2009 Alpha Data


ADMXRC2_SPACE_INFO

Declaration

typedef struct _ADMXRC2_SPACE_INFO
{
    void*         VirtualBase;
    unsigned long VirtualSize;
    uint32_t      PhysicalBase;
    uint32_t      LocalBase;
    unsigned long LocalSize;
} ADMXRC2_SPACE_INFO;

Description

The ADMXRC2_SPACE_INFO structure is returned by ADMXRC2_GetSpaceInfo and contains information about a region of local bus space on a card.

The PhysicalBase member is the address of the region in the address space of the bus on which the card resides. For example, an ADM-XRC card is a PCI Mezzanine Card so this value would represent the PCI address of the beginning of the region.

The LocalBase member is the address of the region in the local bus address space of the card.

The LocalSize member is the size, in bytes, of the FPGA space in the local bus address space of the card.

The VirtualBase member is the address, in the application's address space, by which the region may be accessed using pointers. This member may be NULL, meaning that the region is not mapped into the application's address space.

The VirtualSize member is the size in bytes of the region, in the application's address space. When LocalSize is very large, eg. 256MB, LocalSize may differ from VirtualSize, indicating that the driver was unable to map all of the region into the application's address space. If VirtualBase is NULL, then VirtualSize is 0

Only the local bus space is mapped into the application's address space. In other words, any call to ADMXRC2_GetSpaceInfo with an index other than 0 will return an ADMXRC2_SPACE_INFO structure whose VirtualBase member is NULL and VirtualSize member is 0.

 


 Top of page