Função StorPortGetSystemPortNumber (storport.h)

  • Artigo

A rotina StorPortGetSystemPortNumber recupera o número da porta atribuída pelo sistema para um adaptador de armazenamento.

Sintaxe

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

Parâmetros

[in] HwDeviceExtension

Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).

[in, out] Address

Um ponteiro para uma estrutura de endereço de armazenamento formatada como STOR_ADDR_BTL8. No retorno, o membro Port dessa estrutura conterá o valor da porta atribuído ao adaptador.

Retornar valor

StorPortGetSystemPortNumber retorna um dos seguintes códigos de status:

Código de retorno Descrição
STOR_STATUS_INVALID_DEVICE_STATE
 Um valor de número de porta ainda não foi atribuído ao adaptador de armazenamento.
STOR_STATUS_SUCCESS
 Indica que o número da porta do adaptador de armazenamento foi retornado com êxito.
STOR_STATUS_INVALID_PARAMETER
 O HwDeviceExtension era NULL.

-ou-

O membro Type de Address não é STOR_ADDRESS_TYPE_BTL8.

Comentários

A estrutura de endereço apontada por Address é alocada e formatada como STOR_ADDR_BTL8. O membro Type de Address deve ser definido como STOR_ADDRESS_TYPE_BTL8 e o Endereço do membro Length deve ser maior ou igual a STOR_ADDR_BTL8_ADDRESS_LENGTH.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível em começando com Windows 8.
Plataforma de Destino Universal
Cabeçalho storport.h

Confira também

STOR_ADDRESS

STOR_ADDR_BTL8