структура PCI_SLOT_NUMBER (wdm.h)

Статья
08/08/2023

Структура PCI_SLOT_NUMBERустарела. Он определяет формат параметра Slot для устаревших подпрограмм HalXxxBusData при их вызове со значением BusDataTypePCIConfiguration.

Синтаксис

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;

Члены

u

u.bits

Указывает конкретное устройство в многофункциональном адаптере в заданном настраиваемом слоте. DeviceNumber указывает номер логического слота для адаптера; FunctionNumber указывает конкретное устройство на этом адаптере.

u.bits.DeviceNumber

u.bits.FunctionNumber

u.bits.Reserved

u.AsULONG

Указывает номер логического слота настраиваемого устройства.

Драйверы устройств PCI могут несколько раз вызывать HalGetBusData или HalGetBusDataByOffset для одного и того же номера слота, чтобы получить сведения о конфигурации для своих устройств.

Например, водитель может сначала найти устройства, поддерживаемые на всех шинах PCI на компьютере, а затем снова вызвать HalGetBusData(ByOffset) , чтобы запросить дополнительные сведения о конфигурации интересующих устройств. Такой драйвер может закодировать цикл, который вызывает HalGetBusData(ByOffset) с вводом Buffer , достаточным Length только для того, чтобы содержать достаточно PCI_COMMON_CONFIG для определения VendorID и DeviceID каждого устройства PCI. После поиска Slot номеров для любых перспективных устройств PCI драйвер будет вызывать HalGetBusData или HalGetBusDataByOffset один или несколько раз с дополнительным буферным пространством, чтобы получить сведения, необходимые для настройки своих устройств.