Funzione StorPortAcquireMSISpinLock (storport.h)
La routine StorPortAcquireMSISpinLock acquisisce il blocco di spin di interruzione del messaggio segnalato (MSI) associato al messaggio specificato.
Sintassi
ULONG StorPortAcquireMSISpinLock(
[in] PVOID HwDeviceExtension,
ULONG MessageId,
[in] PULONG OldIrql
);
Parametri
[in] HwDeviceExtension
Puntatore all'estensione del dispositivo hardware per l'adattatore bus host (HBA).
MessageId
Identificatore del messaggio il cui spin lock acquisisce il chiamante.
[in] OldIrql
Puntatore alla risorsa di archiviazione per il valore IRQL originale da usare in una chiamata successiva a StorPortReleaseMSISpinLock.
Valore restituito
StorPortAcquireMSISpinLock restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STOR_STATUS_NOT_IMPLEMENTED | Questa funzione non viene implementata nel sistema operativo attivo. |
| STOR_STATUS_SUCCESS | Indica che il blocco di rotazione è stato acquisito correttamente. |
| STOR_STATUS_INVALID_PARAMETER | HwDeviceExtension è NULL. |
Commenti
Un driver miniport chiama la routine StorPortAcquireMSISpinLock per acquisire il blocco di selezione MSI per un determinato messaggio. Per rilasciare il blocco spin, il driver miniport chiama la routine StorPortReleaseMSISpinLock . Questa routine viene utilizzata da un driver miniport per acquisire un blocco di selezione MSI per un singolo messaggio solo quando il membro InterruptSynchronizationMode della struttura PORT_CONFIGURATION_INFORMATION è impostato su InterruptSynchronizePerMessage.
Quando un miniport deve eseguire la sincronizzazione con tutti i messaggi, può usare una chiamata a StorPortAcquireSpinLock che acquisirà un blocco per ogni messaggio nell'ordine appropriato.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Questa routine è disponibile a partire da Windows Vista. |
| Piattaforma di destinazione | Universale |
| Intestazione | storport.h (include Storport.h) |
| IRQL | Qualsiasi livello |