PCI_SLOT_NUMBER結構（miniport.h）

發行項
02/07/2025

PCI_SLOT_NUMBER 結構過時。它會將 Slot 參數的格式定義為已過時的 HalXxxBusData 例程時，使用 BusDataType 值 PCIConfiguration呼叫。

語法

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)，以要求更多感興趣的裝置組態資訊。這類驅動程式可以撰寫迴圈，以輸入 Buffer 足夠 Length 呼叫 HalGetBusData(ByOffset)，只包含足夠的 PCI_COMMON_CONFIG，以判斷每個PCI裝置的 VendorID 和 DeviceID。在找到任何有前途的PCI裝置 Slot 號碼之後，驅動程式會呼叫 HalGetBusData 或 HalGetBusDataByOffset 一或多次，並具有額外的緩衝區空間，以取得設定其裝置所需的資訊。