Compartilhar via


Função StorPortGetMSIInfo (storport.h)

A rotina StorPortGetMSIInfo recupera as informações de MSI (interrupção sinalizada por mensagem) para a mensagem especificada.

Sintaxe

ULONG StorPortGetMSIInfo(
  [in]  PVOID                          HwDeviceExtension,
  [in]  ULONG                          MessageId,
  [out] PMESSAGE_INTERRUPT_INFORMATION InterruptInfo
);

Parâmetros

[in] HwDeviceExtension

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

[in] MessageId

O identificador da mensagem para a qual as informações são recuperadas.

[out] InterruptInfo

Um ponteiro para uma estrutura de MESSAGE_INTERRUPT_INFORMATION fornecida pelo driver de miniport que recebe as informações da mensagem especificada pelo parâmetro MessageId .

Retornar valor

StorPortGetMSIInfo retorna um dos códigos status:

Código de retorno Descrição
STOR_STATUS_NOT_IMPLEMENTED
Essa função não é implementada no sistema operacional ativo.
STOR_STATUS_SUCCESS
Indica que as informações da MSI foram recebidas com êxito para a mensagem especificada.
STOR_STATUS_INVALID_PARAMETER
HwDeviceExtension passado era NULL.

-ou-

O ponteiro em InterruptInfo para a estrutura a receber as informações é NULL.

-ou-

MessageId passada para a função está incorreta.

STOR_STATUS_INVALID_DEVICE_REQUEST
O HBA não dá suporte à MSI.

Requisitos

Requisito Valor
Cliente mínimo com suporte Essa rotina está disponível a partir do Windows Vista.
Plataforma de Destino Universal
Cabeçalho storport.h (inclua Storport.h)
IRQL Qualquer nível.

Confira também

MESSAGE_INTERRUPT_INFORMATION