Función ExInterlockedFlushSList (wdm.h)
El ExInterlockedFlushSList rutina quita de forma atómica todas las entradas de una lista vinculada secuenciada.
Sintaxis
NTKERNELAPI
PSLIST_ENTRY
FASTCALL
ExInterlockedFlushSList (
_Inout_ PSLIST_HEADER ListHead
);
Parámetros
[in, out] ListHead
Puntero a la estructura SLIST_HEADER que actúa como encabezado de la lista vinculada secuenciada.
Valor devuelto
Si había entradas en la lista especificada, ExInterlockedFlushSList devuelve un puntero a la primera estructura de SLIST_ENTRY que era una entrada de la lista; de lo contrario, devuelve NULL.
Observaciones
ExInterlockedFlushSList no elimina las estructuras de SLIST_ENTRY que componen la lista; solo establece el puntero interno de ListHead al principio de la lista para null. El controlador debe liberar las entradas explícitamente.
La rutina devuelve un puntero a la primera estructura SLIST_ENTRY que estaba en la lista. El controlador puede usar este puntero para recorrer en iteración las entradas.
Para obtener más información sobre el uso de esta rutina para implementar una lista vinculada secuenciadamente, vea Listas vinculadas duplicadas y.
Los autores de llamadas de exInterlockedFlushSList se pueden ejecutar en cualquier IRQL. El almacenamiento del parámetro ListHead de y las entradas de lista deben estar residentes en todos los IRQL.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 2000. |
| de la plataforma de destino de | Universal |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | Cualquier nivel (consulte la sección Comentarios) |