Compartir a través de


Función StorPortGetSystemPortNumber (storport.h)

La rutina StorPortGetSystemPortNumber recupera el número de puerto asignado por el sistema para un adaptador de almacenamiento.

Sintaxis

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

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).

[in, out] Address

Puntero a una estructura de direcciones de almacenamiento con formato STOR_ADDR_BTL8. A cambio, el miembro Port de esta estructura contendrá el valor de puerto asignado al adaptador.

Valor devuelto

StorPortGetSystemPortNumber devuelve uno de los siguientes códigos de estado:

Código devuelto Descripción
STOR_STATUS_INVALID_DEVICE_STATE
Todavía no se ha asignado un valor de número de puerto al adaptador de almacenamiento.
STOR_STATUS_SUCCESS
Indica que el número de puerto del adaptador de almacenamiento se devolvió correctamente.
STOR_STATUS_INVALID_PARAMETER
HwDeviceExtension era NULL.

O bien

El miembro Type de Address no es STOR_ADDRESS_TYPE_BTL8.

Comentarios

La estructura de direcciones a la que apunta Address se asigna y da formato a STOR_ADDR_BTL8. El miembro Type de Address debe establecerse en STOR_ADDRESS_TYPE_BTL8 y la dirección del miembro Length debe ser mayor o igual que STOR_ADDR_BTL8_ADDRESS_LENGTH.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en a partir de Windows 8.
Plataforma de destino Universal
Encabezado storport.h

Consulte también

STOR_ADDRESS

STOR_ADDR_BTL8