Partager via


StorPortInterlockedFlushSList, fonction (storport.h)

Supprime tous les éléments d’une liste liée gérée par Storport. L’accès à la liste est synchronisé sur un système multiprocesseur

Syntaxe

ULONG StorPortInterlockedFlushSList(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead,
  [out]     PSTOR_SLIST_ENTRY  *Result
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).

[in, out] SListHead

Pointeur vers une structure STOR_SLIST_HEADER qui représente la tête d’une liste liée de manière singly. Cette structure est considérée comme opaque et est utilisée uniquement par le pilote Storport.

[out] Result

Pointeur vers un pointeur d’entrée de liste. La valeur retournée est un pointeur vers les éléments supprimés de la liste. Si la liste est vide, NULL est retournée dans la valeur pointée par Result.

Valeur de retour

StorPortInterlockedFlushSList retourne l’un des codes d’état suivants :

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
Les éléments de liste ont été supprimés correctement ou la liste est déjà vide.
STOR_STATUS_INVALID_PARAMETER
Un pointeur dans SListHead ou Result est NULL.

Remarques

Le StorPortInterlockedFlushSList retourne également STATUS_SUCCESS lorsqu’aucune entrée n’est dans la liste. La valeur de pointeur référencée par Result doit être évaluée pour NULL pour vérifier qu’aucune entrée n’a été retournée.

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows 8.
plateforme cible Universel
d’en-tête storport.h (include Storport.h)
IRQL <= DISPATCH_LEVEL

Voir aussi

StorPortInitializeSListHead

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList

StorPortQueryDepthSList