StorPortGetSystemPortNumber-Funktion (storport.h)

Die StorPortGetSystemPortNumber Routine ruft die vom System zugewiesene Portnummer für einen Speicheradapter ab.

Syntax

ULONG StorPortGetSystemPortNumber(
  [in]      PVOID         HwDeviceExtension,
  [in, out] PSTOR_ADDRESS Address
);

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung für den Hostbusadapter (HBA).

[in, out] Address

Ein Zeiger auf eine Speicheradressenstruktur, die als STOR_ADDR_BTL8formatiert ist. Im Gegenzug enthält das Port Mitglied dieser Struktur den dem Adapter zugewiesenen Portwert.

Rückgabewert

StorPortGetSystemPortNumber gibt einen der folgenden Statuscodes zurück:

Rückgabecode	Beschreibung
STOR_STATUS_INVALID_DEVICE_STATE	Dem Speicheradapter wird noch kein Portnummernwert zugewiesen.
STOR_STATUS_SUCCESS	Gibt an, dass die Portnummer des Speicheradapters erfolgreich zurückgegeben wurde.
STOR_STATUS_INVALID_PARAMETER	Die HwDeviceExtension- war NULL-. -oder- Das Mitglied der Adresse ist nicht STOR_ADDRESS_TYPE_BTL8.

Bemerkungen

Die Adressstruktur, auf die durch Address verwiesen wird, wird als STOR_ADDR_BTL8zugewiesen und formatiert. Der Typ Mitglied der Address muss auf STOR_ADDRESS_TYPE_BTL8 festgelegt sein, und das Mitglied Address muss größer oder gleich STOR_ADDR_BTL8_ADDRESS_LENGTHsein.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Ab Windows 8 verfügbar.
Zielplattform-	Universal
Header-	storport.h

Siehe auch

STOR_ADDRESS

STOR_ADDR_BTL8