StorPortInitializeSListHead, fonction (storport.h)
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 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.
Valeur de retour
StorPortInitializeSListHead retourne l’un des codes d’état suivants :
| Retourner le code | Description |
|---|---|
|
Cette fonction n’est pas implémentée sur le système d’exploitation actif. |
|
La tête de liste pointée par SListHead a été initialisée avec succès. |
|
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 de MEMORY_ALLOCATION_ALIGNMENT. MEMORY_ALLOCATION_ALIGNMENT est défini dans miniport.h.
Lorsque la mémoire de la 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 de MEMORY_ALLOCATION_ALIGNMENT.
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
StorPortInterlockedPopEntrySList