Fonction StorPortQueryDepthSList (storport.h)

Article
02/29/2024

Récupère le nombre d’entrées dans une liste liée unique 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 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 une valeur SHORT qui reçoit le nombre de profondeurs de liste.

Valeur retournée

StorPortQueryDepthSList 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	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é, la valeur de profondeur de liste pointée par Result lors du retour n’est pas fiable lorsque plusieurs threads opèrent sur la liste.

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

StorPortInterlockedFlushsList

StorPortInterlockedPopEntrysList

StorPortInterlockedPushEntrysList

Partager via