StorPortAcquireMSISpinLock, fonction (storport.h)
L'StorPortAcquireMSISpinLock routine acquiert le verrou de rotation d’interruption signalé par le message (MSI) associé au message spécifié.
ULONG StorPortAcquireMSISpinLock(
[in] PVOID HwDeviceExtension,
ULONG MessageId,
[in] PULONG OldIrql
);
[in] HwDeviceExtension
Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).
MessageId
Identificateur du message dont la rotation verrouille l’appelant acquiert.
[in] OldIrql
Pointeur vers le stockage de la valeur IRQL d’origine à utiliser dans un appel ultérieur à StorPortReleaseMSISpinLock.
StorPortAcquireMSISpinLock retourne l’une des valeurs suivantes :
Retourner le code | Description |
---|---|
STOR_STATUS_NOT_IMPLEMENTED | Cette fonction n’est pas implémentée sur le système d’exploitation actif. |
STOR_STATUS_SUCCESS | Indique que le verrou de rotation a été acquis avec succès. |
STOR_STATUS_INVALID_PARAMETER | Le HwDeviceExtension était NULL. |
Un pilote miniport appelle la routine StorPortAcquireMSISpinLock pour acquérir le verrou de rotation MSI pour un message particulier. Pour libérer le verrou de rotation, le pilote miniport appelle la routine StorPortReleaseMSISpinLock. Cette routine est utilisée par des pilotes miniports pour acquérir un verrou de rotation MSI pour un message individuel uniquement lorsque le membre InterruptSynchronizationMode de la structure PORT_CONFIGURATION_INFORMATION est défini sur InterruptSynchronizePerMessage.
Lorsqu’un miniport doit être synchronisé avec tous les messages, il peut utiliser un appel pour StorPortAcquireSpinLock qui acquiert un verrou pour chaque message dans l’ordre approprié.
Exigence | Valeur |
---|---|
client minimum pris en charge | Cette routine est disponible à partir de Windows Vista. |
plateforme cible | Universel |
d’en-tête | storport.h (include Storport.h) |
IRQL | N’importe quel niveau |