Funzione StorPortAcquireMSISpinLock (storport.h)
La routine StorPortAcquireMSISpinLock acquisisce il blocco di selezione dell'interrupt segnalato dal messaggio 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 la scheda 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 selezione è stato acquisito correttamente. |
| STOR_STATUS_INVALID_PARAMETER | Il HwDeviceExtension è stato NULL. |
Osservazioni
Un driver miniport chiama la routine StorPortAcquireMSISpinLock per acquisire il blocco di selezione MSI per un determinato messaggio. Per rilasciare il blocco di selezione, il driver miniport chiama la routineStorPortReleaseMSISpinLock. Questa routine viene utilizzata da un miniport driver per acquisire un blocco di selezione MSI per un singolo messaggio solo quando il InterruptSynchronizationMode membro della struttura PORT_CONFIGURATION_INFORMATION è impostato su InterruptSynchronizePerMessage.
Quando un miniport deve eseguire la sincronizzazione con tutti i messaggi, può usare una chiamata per StorPortAcquireSpinLock che acquisirà un blocco per ogni messaggio nell'ordine corretto.
Fabbisogno
| 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 |