StorPortGetMSIInfo-Funktion (storport.h)

Die StorPortGetMSIInfo-Routine ruft die MSI-Informationen (Message Signaled Interrupt) für die angegebene Nachricht ab.

Syntax

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

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung für den Host bus adapter (HBA).

[in] MessageId

Der Bezeichner der Nachricht, für die die Informationen abgerufen werden.

[out] InterruptInfo

Ein Zeiger auf eine vom Miniporttreiber bereitgestellte MESSAGE_INTERRUPT_INFORMATION Struktur, die die Informationen für die vom MessageId-Parameter angegebene Nachricht empfängt.

Rückgabewert

StorPortGetMSIInfo gibt einen der status Codes zurück:

Rückgabecode Beschreibung
STOR_STATUS_NOT_IMPLEMENTED
Diese Funktion ist auf dem aktiven Betriebssystem nicht implementiert.
STOR_STATUS_SUCCESS
Gibt an, dass die MSI-Informationen für die angegebene Nachricht erfolgreich empfangen wurden.
STOR_STATUS_INVALID_PARAMETER
HwDeviceExtension wurde übergeben.

Oder

Der Zeiger in InterruptInfo für die Struktur, die die Informationen empfangen soll, ist NULL.

Oder

MessageId , die an die Funktion übergeben wird, ist falsch.

STOR_STATUS_INVALID_DEVICE_REQUEST
Der HBA unterstützt MSI nicht.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Diese Routine ist ab Windows Vista verfügbar.
Zielplattform Universell
Header storport.h (Storport.h einschließen)
IRQL Beliebige Ebene.

Weitere Informationen

MESSAGE_INTERRUPT_INFORMATION