StorPortGetBusData-Funktion (storport.h)

Artikel
02/26/2024

Die StorPortGetBusData-Routine ruft die busspezifischen Konfigurationsinformationen ab, die zum Initialisieren des HBA erforderlich sind.

Syntax

STORPORT_API ULONG StorPortGetBusData(
  [in]      PVOID DeviceExtension,
  [in]      ULONG BusDataType,
  [in]      ULONG SystemIoBusNumber,
  [in]      ULONG SlotNumber,
  [in, out] PVOID Buffer,
  [in]      ULONG Length
);

Parameter

[in] DeviceExtension

Zeiger auf den Speicherbereich des Miniporttreibers pro HBA.

[in] BusDataType

Enthält einen Wert vom Typ BUS_DATA_TYPE , der den Typ der zurückzugebenden busspezifischen Konfigurationsdaten angibt. Derzeit kann dieser Wert einer der folgenden Werte sein: Cmos, EisaConfiguration, Pos oder PCIConfiguration. In Zukunft werden jedoch weitere Buskonfigurationstypen unterstützt. Die obere Grenze für die unterstützten Typen ist immer MaximumBusDataType.

[in] SystemIoBusNumber

Gibt die systemseitig zugewiesene Nummer des E/A-Busses an. Die HwStorFindAdapter-Routine des Miniporttreibers ruft diesen Wert aus dem SystemIoBusNumber-Element ab, das ursprünglich in PORT_CONFIGURATION_INFORMATION festgelegt wurde.

[in] SlotNumber

Gibt die logische Slotnummer oder den Standort des Geräts an.

Wenn PCIConfiguration als BusDataType angegeben ist, muss dieser Parameter als PCI_SLOT_NUMBER-type-Wert angegeben werden.

[in, out] Buffer

Zeiger auf einen Puffer oder Bereich, an den die Konfigurationsdaten zurückgegeben werden, oder zeigt, wenn die angegebene Länge null ist, auf einen Speicherort, an den der betriebssystemspezifische Porttreiber einen Zeiger auf einen Puffer zurückgibt, den er zuordnet.

[in] Length

Gibt die maximale Anzahl von Bytes an, die bei Puffer zurückgegeben werden sollen, oder null, wenn der Aufrufer den betriebssystemspezifischen Porttreiber zum Zuordnen eines Puffers zum Enthalten der Daten benötigt.

Rückgabewert

StorPortGetBusData gibt die Anzahl der Im Puffer gespeicherten Konfigurationsinformationen in Bytes zurück. Wenn die BusDataType-EingabePCIConfiguration ist, kann StorPortGetBusData einen der folgenden Werte zurückgeben, um auf einen Fehler hinzuweisen.

Rückgabecode	Beschreibung
0 (Null)	Der PCI-Bus ist nicht vorhanden.
2	Der PCI-Bus ist vorhanden, aber es gibt kein Gerät an der angegebenen PCI-SlotNumber. Der Puffer enthält den Wert, der am PCI_COMMON_CONFIG VendorId-Member PCI_INVALID_VENDOR_ID wird.

Hinweise

Ein Miniporttreiber kann StorPortGetBusData aus den folgenden Routinen aufrufen:

Aus der HwStorFindAdapter-Rückrufroutine .
Aus dessen HwStorAdapterControl nur, wenn controlTypeScsiSetRunningConfig ist.

Aufrufe von anderen Miniporttreiberroutinen führen zu Systemfehlern oder zu einem falschen Betrieb für den Aufrufer.

Von StorPortGetBusData zurückgegebene Konfigurationsdaten sind nur gültig, bis der Miniporttreiber StorPortGetBusData erneut aufruft . Sobald die HwStorFindAdapter-Routine des Aufrufers die Steuerung zurückgibt, werden alle zurückgegebenen Konfigurationsdaten ungültig.