Partager via


StorPortQueryDepthSList, fonction (storport.h)

Récupère le nombre d’entrées dans une liste liée gérée par Storport.

Syntaxe

ULONG StorPortQueryDepthSList(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead,
  [out]     PSHORT             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 une valeur SHORT qui reçoit le nombre de profondeurs de liste.

Valeur de retour

StorPortQueryDepthSList 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
La profondeur de liste a été retournée avec succès.
STOR_STATUS_INVALID_PARAMETER
Un pointeur dans SListHead ou Result est NULL.

Remarques

Étant donné que StorPortQueryDepthSList n’est pas verrouillée, la valeur de profondeur de liste pointée par Result lors du retour n’est pas fiable lorsque plusieurs threads fonctionnent sur la liste.

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

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList