Função StorPortGetMSIInfo (storport.h)

Artigo
02/07/2025

A rotina StorPortGetMSIInfo recupera as informações de MSI (interrupção sinalizada por mensagem) da 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 miniporto que recebe as informações da mensagem especificada pelo parâmetro MessageId.

Valor de retorno

StorPortGetMSIInfo retorna um dos códigos de 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 foi NULL . -ou- O ponteiro em InterruptInfo para a estrutura receber as informações é NULL. -ou- MessageId passado para a função está incorreto.
STOR_STATUS_INVALID_DEVICE_REQUEST	O HBA não dá suporte à MSI.

Requisitos

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

Consulte também

MESSAGE_INTERRUPT_INFORMATION

Partilhar via