Lire en anglais

Partager via


StorPortAcquireMSISpinLock, fonction (storport.h)

L'StorPortAcquireMSISpinLock routine acquiert le verrou de rotation d’interruption signalé par le message (MSI) associé au message spécifié.

Syntaxe

ULONG StorPortAcquireMSISpinLock(
  [in] PVOID  HwDeviceExtension,
       ULONG  MessageId,
  [in] PULONG OldIrql
);

Paramètres

[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.

Valeur de retour

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.

Remarques

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é.

Exigences

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

Voir aussi

PORT_CONFIGURATION_INFORMATION

StorPortAcquireSpinLock

StorPortReleaseMSISpinLock