StorPortAcquireMSISpinLock-Funktion (storport.h)
Die StorPortAcquireMSISpinLock Routine erhält die Message signaled interrupt (MSI)-Drehsperre, die der angegebenen Nachricht zugeordnet ist.
Syntax
ULONG StorPortAcquireMSISpinLock(
[in] PVOID HwDeviceExtension,
ULONG MessageId,
[in] PULONG OldIrql
);
Parameter
[in] HwDeviceExtension
Ein Zeiger auf die Hardwaregeräteerweiterung für den Hostbusadapter (HBA).
MessageId
Der Bezeichner der Nachricht, deren Drehungssperre der Aufrufer abruft.
[in] OldIrql
Ein Zeiger auf den Speicher für den ursprünglichen IRQL-Wert, der in einem nachfolgenden Aufruf von StorPortReleaseMSISpinLockverwendet werden soll.
Rückgabewert
StorPortAcquireMSISpinLock gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STOR_STATUS_NOT_IMPLEMENTED | Diese Funktion ist nicht auf dem aktiven Betriebssystem implementiert. |
| STOR_STATUS_SUCCESS | Gibt an, dass die Drehungssperre erfolgreich erworben wurde. |
| STOR_STATUS_INVALID_PARAMETER | Die HwDeviceExtension- war NULL-. |
Bemerkungen
Ein Miniporttreiber ruft den StorPortAcquireMSISpinLock Routine auf, um die MSI-Drehsperre für eine bestimmte Nachricht abzurufen. Um die Drehsperre freizugeben, ruft der Miniporttreiber die StorPortReleaseMSISpinLock Routine auf. Diese Routine wird von einem Miniporttreiber verwendet, um eine MSI-Drehsperre für eine einzelne Nachricht nur abzurufen, wenn das InterruptSynchronizationMode Member der PORT_CONFIGURATION_INFORMATION-Struktur auf InterruptSynchronizePerMessagefestgelegt ist.
Wenn ein Miniport mit allen Nachrichten synchronisiert werden muss, kann er einen Aufruf StorPortAcquireSpinLock verwenden, der eine Sperre für jede Nachricht in der richtigen Reihenfolge abruft.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Diese Routine ist ab Windows Vista verfügbar. |
| Zielplattform- | Universal |
| Header- | storport.h (include Storport.h) |
| IRQL- | Beliebige Ebene |