Fonction StorPortInitializeSListHead (storport.h)

Article
02/29/2024

Initialise la tête d’une liste liée gérée par Storport.

Syntaxe

ULONG StorPortInitializeSListHead(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead
);

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 le tête d’une liste liée séparément. Cette structure est considérée comme opaque et est uniquement destinée au pilote Storport.

Valeur retournée

StorPortInitializeSListHead 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	L’en-tête de liste pointé par SListHead a été initialisé avec succès.
STOR_STATUS_INVALID_PARAMETER	Le pointeur dans SListHead est NULL.

Remarques

Lorsqu’elle est allouée par l’appelant, la structure STOR_SLIST_HEADER pointée par SListHead doit être alignée à une limite MEMORY_ALLOCATION_ALIGNMENT . MEMORY_ALLOCATION_ALIGNMENT est défini dans miniport.h.

Lorsque la mémoire de l’en-tête de liste est libérée, tout code de désallocation doit tenir compte de l’emplacement d’origine de la mémoire tampon contenant la structure de tête de liste avant l’ajustement pour MEMORY_ALLOCATION_ALIGNMENT.

Configuration requise

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

Voir aussi

StorPortInterlockedFlushsList

StorPortInterlockedPopEntrysList

StorPortInterlockedPushEntrysList

StorPortQueryDepthSList

Partager via