Fonction StorPortGetSystemPortNumber (storport.h)

La routine StorPortGetSystemPortNumber récupère le numéro de port attribué par le système pour une carte de stockage.

Syntaxe

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

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).

[in, out] Address

Pointeur vers une structure d’adresse de stockage mise en forme en tant que STOR_ADDR_BTL8. Au retour, le membre Port de cette structure contient la valeur de port affectée à l’adaptateur.

Valeur retournée

StorPortGetSystemPortNumber retourne l’un des codes status suivants :

Code de retour	Description
STOR_STATUS_INVALID_DEVICE_STATE	Une valeur de numéro de port n’est pas encore attribuée à l’adaptateur de stockage.
STOR_STATUS_SUCCESS	Indique que le numéro de port de l’adaptateur de stockage a été retourné avec succès.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension était NULL. -ou- Le membre Type de Address n’est pas STOR_ADDRESS_TYPE_BTL8.

Remarques

La structure d’adresses pointée par Adresse est allouée et mise en forme comme STOR_ADDR_BTL8. Le membre Type de Address doit être défini sur STOR_ADDRESS_TYPE_BTL8 et l’adresse du membre Length doit être supérieure ou égale à STOR_ADDR_BTL8_ADDRESS_LENGTH.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 8.
Plateforme cible	Universal
En-tête	storport.h

Voir aussi

STOR_ADDRESS

STOR_ADDR_BTL8