structure PCI_SLOT_NUMBER (miniport.h)

Article
02/26/2024

La structure PCI_SLOT_NUMBER est obsolète. Il définit le format du paramètre Slot pour les routines HalXxxBusData obsolètes lorsqu’elles sont appelées avec la valeur BusDataTypePCIConfiguration.

Syntaxe

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;

Membres

u

u.bits

Spécifie l’appareil particulier sur un adaptateur multifonction à l’emplacement donné en cours de configuration. DeviceNumber indique le numéro d’emplacement logique de l’adaptateur ; FunctionNumber indique l’appareil particulier sur cette carte.

u.bits.DeviceNumber

u.bits.FunctionNumber

u.bits.Reserved

u.AsULONG

Spécifie le numéro d’emplacement logique de l’appareil en cours de configuration.

Remarques

Les pilotes d’appareils PCI peuvent appeler HalGetBusData ou HalGetBusDataByOffset plusieurs fois pour le même numéro d’emplacement afin d’obtenir les informations de configuration de leurs appareils.

Par exemple, un pilote peut d’abord rechercher les appareils qu’il prend en charge sur tous les bus PCI de l’ordinateur, puis appeler HalGetBusData(ByOffset) à nouveau pour demander des informations de configuration supplémentaires sur les appareils d’intérêt. Un tel pilote peut coder une boucle qui appelle HalGetBusData(ByOffset) avec une entrée Buffer suffisante Length pour contenir suffisamment de PCI_COMMON_CONFIG pour déterminer le VendorID et DeviceID de chaque périphérique PCI. Après avoir trouvé les Slot numéros de tous les périphériques PCI prometteurs, le pilote appelle HalGetBusData ou HalGetBusDataByOffset une ou plusieurs fois avec un espace tampon supplémentaire pour obtenir les informations nécessaires à la configuration de ses appareils.