Funzione StorPortGetSystemPortNumber (storport.h)

  • Articolo

La routine StorPortGetSystemPortNumber recupera il numero di porta assegnato dal sistema per una scheda di archiviazione.

Sintassi

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

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore bus host (HBA).

[in, out] Address

Puntatore a una struttura di indirizzi di archiviazione formattata come STOR_ADDR_BTL8. In caso di restituzione, il membro Port di questa struttura conterrà il valore della porta assegnato all'adattatore.

Valore restituito

StorPortGetSystemPortNumber restituisce uno dei codici di stato seguenti:

Codice restituito Descrizione
STOR_STATUS_INVALID_DEVICE_STATE
 Un valore del numero di porta non è ancora assegnato all'adattatore di archiviazione.
STOR_STATUS_SUCCESS
 Indica che il numero di porta dell'adattatore di archiviazione è stato restituito correttamente.
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension è NULL.

-oppure-

Il membro Type di Address non è STOR_ADDRESS_TYPE_BTL8.

Commenti

La struttura degli indirizzi a cui punta Address viene allocata e formattata come STOR_ADDR_BTL8. Il membro Type di Address deve essere impostato su STOR_ADDRESS_TYPE_BTL8 e l'indirizzo del membro Length deve essere maggiore o uguale a STOR_ADDR_BTL8_ADDRESS_LENGTH.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 8.
Piattaforma di destinazione Universale
Intestazione storport.h

Vedi anche

STOR_ADDRESS

STOR_ADDR_BTL8