struttura PCI_SLOT_NUMBER (wdm.h)

Articolo
08/08/2023

La struttura PCI_SLOT_NUMBER è obsoleta. Definisce il formato del parametro Slot per le routine HalXxxBusData obsolete quando vengono chiamate con il valore BusDataTypePCIConfiguration.

Sintassi

typedef struct _PCI_SLOT_NUMBER {
  union {
    struct {
      ULONG DeviceNumber : 5;
      ULONG FunctionNumber : 3;
      ULONG Reserved : 24;
    } bits;
    ULONG AsULONG;
  } u;
} PCI_SLOT_NUMBER, *PPCI_SLOT_NUMBER;

Members

u

u.bits

Specifica il dispositivo specifico in una scheda multifunzione nello slot specificato configurato. DeviceNumber indica il numero di slot logico per l'adattatore; FunctionNumber indica il dispositivo specifico nell'adattatore.

u.bits.DeviceNumber

u.bits.FunctionNumber

u.bits.Reserved

u.AsULONG

Specifica il numero di slot logico del dispositivo da configurare.

Commenti

I driver dei dispositivi PCI possono chiamare HalGetBusData o HalGetBusDataByOffset più volte per lo stesso numero di slot per ottenere le informazioni di configurazione per i dispositivi.

Ad esempio, un driver potrebbe cercare i dispositivi supportati in tutti gli autobus PCI nel computer e quindi chiamare HalGetBusData(ByOffset) di nuovo per richiedere altre informazioni di configurazione sui dispositivi di interesse. Un driver di questo tipo potrebbe codificare un ciclo che chiama HalGetBusData(ByOffset) con un input Buffer sufficiente Length a contenere abbastanza del PCI_COMMON_CONFIG per determinare e VendorIDDeviceID di ogni dispositivo PCI. Dopo aver trovato i Slot numeri per qualsiasi dispositivo PCI promettente, il driver chiamerebbe HalGetBusData o HalGetBusDataByOffset una o più volte con spazio di buffer aggiuntivo per ottenere le informazioni necessarie per configurare i dispositivi.