Partager via


Fonction StorPortInterlockedFlushSList (storport.h)

Supprime tous les éléments d’une liste liée unique 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 de STOR_SLIST_HEADER qui représente la tête d’une liste liée séparément. Cette structure est considérée comme opaque et est destinée uniquement au 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, la valeur NULL est retournée dans la valeur pointée par Result.

Valeur retournée

StorPortInterlockedFlushSList retourne l’un des codes status suivants :

Code de retour 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

StorPortInterlockedFlushSList retourne également STATUS_SUCCESS lorsqu’aucune entrée ne se trouve 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans à partir de Windows 8.
Plateforme cible Universal
En-tête storport.h (inclure Storport.h)
IRQL <= DISPATCH_LEVEL

Voir aussi

StorPortInitializesListHead

StorPortInterlockedPopEntrysList

StorPortInterlockedPushEntrysList

StorPortQueryDepthSList