pci-id.h File Reference

PCI ID-related data structures. More...

Go to the source code of this file.

Classes
struct	SubDevice
struct	Device
struct	Vendor

Macros
#define	PCI_ID_AS_STR_LENGTH   (sizeof(UINT16) * 2)
#define	PCI_NAME_STR_LENGTH   255
#define	PCI_ID_DATABASE_PATH   "constants\\pci.ids"

Typedefs
typedef struct SubDevice	SubDevice
typedef struct Device	Device
typedef struct Vendor	Vendor

Functions
Vendor *	GetVendorById (UINT16 VendorId)
	Returns Vendor entry, including corresponding devices and subdevices.
void	FreeVendor (Vendor *VendorToFree)
	Frees Vendor and all of its members.
void	FreePciIdDatabase ()
	Frees PciIdDatabaseBuffer.
Device *	GetDeviceFromVendor (Vendor *VendorToUse, UINT16 DeviceId)
	Returns Device entry corresponding to DeviceId.
SubDevice *	GetSubDeviceFromDevice (Device *DeviceToUse, UINT16 SubVendorId, UINT16 SubDeviceId)
	Returns SubDevice entry corresponding to SubVendorId and DeviceId.

Detailed Description

PCI ID-related data structures.

Author

Bj�rn Ruytenberg (bjorn.nosp@m.@bjo.nosp@m.rnweb.nosp@m..nl)

Version

0.12

Date

2024-12-04

Copyright

This project is released under the GNU Public License v3.

Macro Definition Documentation

PCI_ID_AS_STR_LENGTH

#define PCI_ID_AS_STR_LENGTH   (sizeof(UINT16) * 2)

PCI_ID_DATABASE_PATH

#define PCI_ID_DATABASE_PATH   "constants\\pci.ids"

PCI_NAME_STR_LENGTH

#define PCI_NAME_STR_LENGTH   255

Typedef Documentation

Device

typedef struct Device Device

SubDevice

typedef struct SubDevice SubDevice

Vendor

typedef struct Vendor Vendor

Function Documentation

FreePciIdDatabase()

void FreePciIdDatabase

(

)

Frees PciIdDatabaseBuffer.

Returns

VOID

{
    if (PciIdDatabaseBuffer != NULL)
    {
        free(PciIdDatabaseBuffer);
        PciIdDatabaseBuffer = NULL;
    }
}

FreeVendor()

void FreeVendor

(

Vendor *

VendorToFree

)

Frees Vendor and all of its members.

Parameters

VendorToFree

Returns

VOID

{
    if (VendorToFree == NULL)
        return;
 
    Device * CurrentDevice = VendorToFree->Devices;
    while (CurrentDevice)
    {
        SubDevice * CurrentSubDevice = CurrentDevice->SubDevices;
 
        while (CurrentSubDevice)
        {
            SubDevice * NextSubDevice = CurrentSubDevice->Next;
            free(CurrentSubDevice);
            CurrentSubDevice = NextSubDevice;
        }
 
        Device * NextDevice = CurrentDevice->Next;
        free(CurrentDevice);
        CurrentDevice = NextDevice;
    }
}

GetDeviceFromVendor()

Device * GetDeviceFromVendor	(	Vendor *	VendorToUse,
		UINT16	DeviceId )

Returns Device entry corresponding to DeviceId.

Parameters

VendorToUse
DeviceId

Returns

Device

{
    Device * CurrentDevice = NULL;
    if (!VendorToUse)
    {
        return NULL;
    }
 
    CurrentDevice = VendorToUse->Devices;
    while (CurrentDevice != NULL)
    {
        if (CurrentDevice->DeviceId == DeviceId)
        {
            return CurrentDevice;
        }
        CurrentDevice = CurrentDevice->Next;
    }
    return NULL;
}

GetSubDeviceFromDevice()

SubDevice * GetSubDeviceFromDevice	(	Device *	DeviceToUse,
		UINT16	SubVendorId,
		UINT16	SubDeviceId )

Returns SubDevice entry corresponding to SubVendorId and DeviceId.

Parameters

DeviceToUse
SubVendorId
SubDeviceId

Returns

SubDevice

{
    SubDevice * CurrentSubDevice = NULL;
    if (!DeviceToUse)
    {
        return NULL;
    }
 
    CurrentSubDevice = DeviceToUse->SubDevices;
    while (CurrentSubDevice != NULL)
    {
        if (CurrentSubDevice->SubVendorId == SubVendorId && CurrentSubDevice->SubDeviceId == SubDeviceId)
        {
            return CurrentSubDevice;
        }
        CurrentSubDevice = CurrentSubDevice->Next;
    }
    return NULL;
}

GetVendorById()

Vendor * GetVendorById

(

UINT16

VendorId

)

Returns Vendor entry, including corresponding devices and subdevices.

Use FreeVendor() on returned Vendor pointer after usage. First call will initialize database - call FreeDatabase() once done querying.

Parameters

VendorId

Returns

Vendor

{
    CHAR    VendorIdAsStr[5];
    CHAR    ExecutablePath[MAX_PATH];
    HMODULE hModule = GetModuleHandle(NULL);
 
    snprintf(VendorIdAsStr, sizeof(VendorIdAsStr), "%04X", VendorId);
    GetModuleFileName(hModule, ExecutablePath, sizeof(ExecutablePath));
 
    // Extract executable name
    CHAR * ExecutableName = strrchr(ExecutablePath, '\\');
    if (ExecutableName != NULL)
    {
        ExecutableName++;
    }
    else
    {
        ExecutableName = ExecutablePath;
    }
 
    // Swap executable name for PCI_ID_DATABASE_PATH
    strncpy(ExecutableName, PCI_ID_DATABASE_PATH, sizeof(PCI_ID_DATABASE_PATH));
 
    return GetVendorByIdStr(ExecutablePath, ToLower(VendorIdAsStr));
}