Função StorPortGetSystemPortNumber (storport.h)

Artigo
02/07/2025

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 porta dessa estrutura conterá o valor da porta atribuído ao adaptador.

Valor de retorno

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 está 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 foi NULL . -ou- O Type membro do Address não é STOR_ADDRESS_TYPE_BTL8.

Código de retorno

Descrição

STOR_STATUS_INVALID_DEVICE_STATE

Um valor de número de porta ainda não está 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 foi NULL .

-ou-

O Type membro do Address não é STOR_ADDRESS_TYPE_BTL8.

Observações

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível para começar com o Windows 8.
da Plataforma de Destino	Universal
cabeçalho	storport.h

Consulte também

STOR_ADDRESS

STOR_ADDR_BTL8

Partilhar via