StorPortGetBusData-Funktion (storport.h)

Artikel
02/07/2025

Die StorPortGetBusData Routine ruft die busspezifischen Konfigurationsinformationen ab, die zum Initialisieren der 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

Zeigen Sie auf den Speicherbereich des Miniporttreibers pro HBA.

[in] BusDataType

Enthält einen Wert vom Typ BUS_DATA_TYPE, der den Typ der busspezifischen Konfigurationsdaten angibt, die zurückgegeben werden sollen. Dieser Wert kann derzeit einer der folgenden sein: , EisaConfiguration, Posoder PCIConfiguration. In Zukunft werden jedoch zusätzliche Buskonfigurationstypen unterstützt. Die obere Grenze der unterstützten Typen wird immer MaximumBusDataType.

[in] SystemIoBusNumber

Gibt die vom System zugewiesene Nummer des E/A-Busses an. Die HwStorFindAdapter- Routine des Miniporttreibers ruft diesen Wert aus dem SystemIoBusNumber Member ab, das anfangs in PORT_CONFIGURATION_INFORMATIONfestgelegt wurde.

[in] SlotNumber

Gibt die nummer oder die Position des Geräts an.

Wenn PCIConfiguration- als BusDataType-angegeben wird, muss dieser Parameter als wert vom Typ PCI_SLOT_NUMBER angegeben werden.

[in, out] Buffer

Zeiger auf einen Puffer oder Einen Bereich, an den die Konfigurationsdaten zurückgegeben werden, oder zeigt, wenn die angegebene Length null ist, auf einen Speicherort, an dem der betriebssystemspezifische Porttreiber einen Zeiger auf einen Puffer zurückgibt, den er zuweist.

[in] Length

Gibt die maximale Anzahl von Bytes an, die bei Bufferzurückgegeben werden sollen, oder null, wenn der Aufrufer den betriebssystemspezifischen Porttreiber benötigt, um einen Puffer für die Daten zuzuweisen.

Rückgabewert

StorPortGetBusData gibt die Anzahl der im Puffer gespeicherten Konfigurationsinformationen zurück. Wenn die Eingabe BusDataTypePCIConfigurationist, kann StorPortGetBusData einen der folgenden Werte zurückgeben, um einen Fehler anzugeben.

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. Die Buffer- enthält den Wert PCI_INVALID_VENDOR_ID PCI_COMMON_CONFIG VendorId Member.

Bemerkungen

Ein Miniporttreiber kann StorPortGetBusData- aus den folgenden Routinen aufrufen:

Von der HwStorFindAdapter Rückrufroutine aus.
Von der HwStorAdapterControl nur, wenn die ControlType-ScsiSetRunningConfigist.

Anrufe von anderen Miniporttreiberroutinen führen zu Systemfehlern oder falschen Vorgängen für den Anrufer.

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