Macro ExInterlockedPushEntrySList (wdm.h)

  • Artículo

La rutina ExInterlockedPushEntrySList inserta de forma atómica una entrada al principio de una lista vinculada secuenciada.

Sintaxis

NTKERNELAPI
PSLIST_ENTRY
FASTCALL
ExInterlockedPushEntrySList (
    _Inout_ PSLIST_HEADER ListHead,
    _Inout_ __drv_aliasesMem PSLIST_ENTRY ListEntry,
    _Inout_opt_ _Requires_lock_not_held_(*_Curr_) PKSPIN_LOCK Lock
    );

Parámetros

ListHead

Puntero a la estructura SLIST_HEADER que actúa como encabezado de la lista vinculada secuenciada. ListHead debe haberse inicializado llamando a ExInitializeSListHead.

ListEntry

Puntero a la entrada asignada por el autor de la llamada que se va a insertar.

[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 ser residente y debe haberse inicializado llamando a KeInitializeSpinLock. Debe usar este bloqueo de número solo con las rutinas ExInterlockedXxxList .

Valor devuelto

Si había entradas en la lista especificada, ExInterlockedPushEntrySList devuelve un puntero a la primera estructura SLIST_ENTRY que era una entrada de la lista; de lo contrario, devuelve NULL.

Comentarios

Para obtener más información sobre el uso de esta rutina para implementar una lista vinculada secuenciadamente, vea Singly and Doblemente vinculado Listas.

En Windows 2000, los controladores deben usar el modificador -D_WIN2K_COMPAT_SLIST_USAGE para vincular correctamente el código que usa ExInterlockedPushEntrySList.

Se puede llamar a la rutina ExInterlockedPushEntrySList en cualquier IRQL. El almacenamiento para el parámetro ListHead y las entradas de lista deben residir en todos los IRQL.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 2000.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL Cualquier nivel (consulte la sección Comentarios)

Consulte también

ExInitializeSListHead

ExInterlockedInsertTailList

ExInterlockedPopEntrySList

ExQueryDepthSList

KeInitializeSpinLock