Función PopEntryList (wdm.h)

La rutina PopEntryList quita la primera entrada de una lista vinculada de forma singly de SINGLE_LIST_ENTRY estructuras.

Sintaxis

PSINGLE_LIST_ENTRY PopEntryList(
  [in, out] PSINGLE_LIST_ENTRY ListHead
);

Parámetros

[in, out] ListHead

Puntero a la estructura SINGLE_LIST_ENTRY que representa el encabezado de la lista. En la devolución, ListHead-Next> apunta al principio de la lista con la primera entrada quitada.

Valor devuelto

PopEntryList devuelve un puntero a la entrada quitada de la lista, o NULL si la lista está vacía actualmente.

Comentarios

PopEntryList quita la primera entrada de la lista estableciendo ListHead-Next> para que apunte a la segunda entrada de la lista.

Para obtener información sobre el uso de esta rutina al implementar una lista vinculada singly, vea Singly and Duplicay Linked Listas.

Los autores de llamadas de PopEntryList se pueden ejecutar en cualquier IRQL. Si se llama a PopEntryList en IRQL >= DISPATCH_LEVEL, el almacenamiento de ListHead y las entradas de lista deben estar residentes.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 2000.
Plataforma de destino	Escritorio
Encabezado	wdm.h (incluye Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
IRQL	Cualquier nivel (consulte la sección Comentarios)

Consulte también

ExInterlockedPopEntryList

PushEntryList