Función ExInterlockedPopEntrySList (wdm.h)
El ExInterlockedPopEntrySList rutina quita de forma atómica la primera entrada de una lista vinculada secuenciadamente.
Sintaxis
NTKERNELAPI
PSLIST_ENTRY
FASTCALL
ExInterlockedPopEntrySList (
_Inout_ PSLIST_HEADER ListHead,
_Inout_opt_ _Requires_lock_not_held_(*_Curr_) PKSPIN_LOCK Lock
);
Parámetros
[in, out] ListHead
Puntero a la estructura SLIST_HEADER que actúa como encabezado de la lista vinculada secuenciada. ListHead debe haberse inicializado llamando a ExInitializeSListHead.
[in, out] Lock
Puntero a una estructura de KSPIN_LOCK que actúa como bloqueo de número usado para sincronizar el acceso a la lista. El almacenamiento del bloqueo de número debe estar residente y debe haberse inicializado llamando a KeInitializeSpinLock. Debe usar este bloqueo de giro solo con las rutinas deXxxList ExInterlocked.
Valor devuelto
ExInterlockedPopEntrySList devuelve un puntero a la primera estructura SLIST_ENTRY de la lista. Si la lista estaba vacía, la rutina devuelve NULL.
Observaciones
Para obtener más información sobre el uso de esta rutina para implementar una lista vinculada secuenciadamente, vea Listas vinculadas duplicadas y.
En Windows 2000, los controladores deben usar el modificador -D_WIN2K_COMPAT_SLIST_USAGE para vincular correctamente el código que usa ExInterlockedPopEntrySList.
se puede llamar a exInterlockedPopEntrySList en cualquier IRQL. El almacenamiento del parámetro ListHead debe estar residente en todos los IRQLs.
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) |