Función InsertHeadList (wdm.h)

Artículo
02/29/2024

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)