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

Vedi anche

PORT_CONFIGURATION_INFORMATION

StorPortAcquireSpinLock

StorPortReleaseMSISpinLock