Freigeben über


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 Host bus adapter (HBA).

[in, out] Address

Ein Zeiger auf eine Speicheradressenstruktur, die als STOR_ADDR_BTL8 formatiert ist. Bei der Rückgabe enthält der Portmember dieser Struktur den Portwert, der dem Adapter zugewiesen ist.

Rückgabewert

StorPortGetSystemPortNumber gibt einen der folgenden status Codes zurück:

Rückgabecode Beschreibung
STOR_STATUS_INVALID_DEVICE_STATE
Dem Speicheradapter ist noch kein Portnummerwert zugewiesen.
STOR_STATUS_SUCCESS
Gibt an, dass die Portnummer des Speicheradapters erfolgreich zurückgegeben wurde.
STOR_STATUS_INVALID_PARAMETER
HwDeviceExtension war NULL.

Oder

Das Type-Element von Address ist nicht STOR_ADDRESS_TYPE_BTL8.

Hinweise

Die Adressstruktur, auf die von Address verwiesen wird, wird zugeordnet und als STOR_ADDR_BTL8 formatiert. Das Type-Element von Address muss auf STOR_ADDRESS_TYPE_BTL8 festgelegt werden, und das LängenelementAdresse muss größer oder gleich STOR_ADDR_BTL8_ADDRESS_LENGTH sein.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 8.
Zielplattform Universell
Header storport.h

Weitere Informationen

STOR_ADDRESS

STOR_ADDR_BTL8