structure PCI_SLOT_NUMBER (wdm.h)
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.
Configuration requise
Condition requise | Valeur |
---|---|
En-tête | wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h, Miniport.h) |