PCI_SLOT_NUMBER-Struktur (wdm.h)

Artikel
02/27/2024

Die PCI_SLOT_NUMBER-Struktur ist veraltet. Es definiert das Format des Slot-Parameters für die veralteten HalXxxBusData-Routinen , wenn sie mit dem BusDataType-WertPCIConfiguration aufgerufen 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;

Member

u

u.bits

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

u.bits.DeviceNumber

u.bits.FunctionNumber

u.bits.Reserved

u.AsULONG

Gibt die logische Slotnummer des konfigurierten Geräts an.

Hinweise

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

Beispielsweise könnte ein Treiber zuerst auf allen PCI-Bussen auf dem Computer nach Geräten suchen, die er unterstützt, und dann erneut aufrufen HalGetBusData(ByOffset) , um weitere Konfigurationsinformationen zu den relevanten Geräten anzufordern. Ein solcher Treiber könnte eine Schleife codieren, die mit einer Ausreichenden Eingabe BufferLength aufruftHalGetBusData(ByOffset), um genügend der PCI_COMMON_CONFIG zu enthalten, um das und DeviceID jedes VendorID PCI-Geräts zu bestimmen. Nachdem er die Slot Zahlen für vielversprechende PCI-Geräte gefunden hat, ruft der Treiber halGetBusData oder HalGetBusDataByOffset ein oder mehrmals mit zusätzlichem Pufferspeicher auf, um die informationen zu erhalten, die zum Konfigurieren seiner Geräte erforderlich sind.