Función InsertHeadList (wdm.h)

La rutina InsertHeadList inserta una entrada en el encabezado de una lista doblemente vinculada de estructuras LIST_ENTRY .

Sintaxis

void InsertHeadList(
  [in, out] PLIST_ENTRY                  ListHead,
  [in, out] __drv_aliasesMem PLIST_ENTRY Entry
);

Parámetros

[in, out] ListHead

Puntero a la estructura LIST_ENTRY que representa el encabezado de la lista.

[in, out] Entry

Puntero a una estructura LIST_ENTRY que representa la entrada que se va a insertar en la lista.

Valor devuelto

None

Observaciones

InsertHeadList actualiza ListHead-Flink> para que apunte a Entry. Actualiza Entry-Flink> para que apunte a la primera entrada anterior de la lista y establece Entry-Blink> en ListHead. El campo Blink de la primera entrada original también se actualiza para que apunte a Entrada.

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

Los autores de llamadas de InsertHeadList se pueden ejecutar en cualquier IRQL. Si se llama a InsertHeadList 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)
Reglas de cumplimiento de DDI IoAllocateFree(wdm), IoReuseIrp(wdm), MarkingQueuedIrps(wdm), RemoveLockCheck(wdm), RemoveLockForward(wdm), RemoveLockForward2(wdm), RemoveLockForwardDeviceControl(wdm), RemoveLockForwardDeviceControl2(wdm), RemoveLockForwardDeviceControlInternal(wdm), RemoveLockForwardDeviceControlInternal2(wdm), RemoveLockForwardRead(wdm), RemoveLockForwardRead2(wdm) , RemoveLockForwardWrite(wdm), RemoveLockForwardWrite2(wdm), RemoveLockRelease2(wdm), RemoveLockReleaseCleanup(wdm), RemoveLockReleaseClose(wdm), RemoveLockReleaseCreate(wdm), RemoveLockReleaseDeviceControl(wdm), RemoveLockReleaseInternalDeviceControl(wdm), RemoveLockReleasePower(wdm), RemoveLockReleaseRead(wdm), RemoveLockReleaseShutdown(wdm), RemoveLockReleaseSystemControl(wdm), RemoveLockReleaseWrite(wdm)

Consulte también

ExInterlockedInsertHeadList

InitializeListHead

InsertTailList

IsListEmpty

RemoveHeadList

RemoveTailList