PCI_SLOT_NUMBER Struktur (wdm.h)

Artikel
02/07/2025

Die PCI_SLOT_NUMBER Struktur ist veraltete. Es definiert das Format des Slot--Parameters für die veralteten HalXxxBusData Routinen, wenn sie mit dem BusDataType Wert PCIConfigurationaufgerufen werden.

Syntax

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;

Angehörige

u

u.bits

Gibt das jeweilige Gerät auf einem Multifunktionsadapter an dem angegebenen Steckplatz an, der konfiguriert wird. Die DeviceNumber- gibt die logische Steckplatznummer für den Adapter an; das FunctionNumber- gibt das jeweilige Gerät auf diesem Adapter an.

u.bits.DeviceNumber

u.bits.FunctionNumber

u.bits.Reserved

u.AsULONG

Gibt die logische Steckplatznummer des zu konfigurierenden Geräts an.

Bemerkungen

Treiber von PCI-Geräten können HalGetBusData- oder HalGetBusDataByOffset- mehrmals für dieselbe Steckplatznummer aufrufen, um die Konfigurationsinformationen für ihre Geräte abzurufen.

Beispielsweise kann ein Treiber zuerst nach Geräten suchen, die er auf allen PCI-Bussen des Computers unterstützt, und dann erneut HalGetBusData(ByOffset) aufrufen, um weitere Konfigurationsinformationen zu interessierten Geräten anzufordern. Ein solcher Treiber könnte eine Schleife codieren, die HalGetBusData(ByOffset) mit einer Eingabe Buffer ausreichender Length aufruft, um nur genügend PCI_COMMON_CONFIG zu enthalten, um die VendorID und DeviceID jedes PCI-Geräts zu ermitteln. Nachdem sie die Slot Nummern für vielversprechende PCI-Geräte gefunden haben, ruft der Treiber HalGetBusData- oder HalGetBusDataByOffset mindestens ein Mal mit zusätzlichem Pufferraum auf, um die informationen abzurufen, die zum Konfigurieren seiner Geräte erforderlich sind.