Compartir a través de


Función InsertHeadList (wdm.h)

El InsertHeadList rutina inserta una entrada en el encabezado de una lista doblemente vinculada de estructuras de 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

Ninguno

Observaciones

InsertHeadList actualiza ListHead:> Flink para apuntar a entrada. Actualiza entrada:> 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 Entry.

Para obtener información sobre cómo usar esta rutina al implementar una lista vinculada doble, consulte Listas vinculadas duplicadas y duplicadas.

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 Valor
cliente mínimo admitido Disponible a partir de Windows 2000.
de la plataforma de destino de Escritorio
encabezado de wdm.h (include 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), RemoveLock, 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), RemoveLockRelease Power(wdm), RemoveLockReleaseRead(wdm), RemoveLockReleaseShutdown(wdm), RemoveLockReleaseSystemControl(wdm), RemoveLockReleaseWrite(wdm)

Consulte también

ExInterlockedInsertHeadList

initializeListHead

InsertTailList

IsListEmpty

RemoveHeadList

RemoveTailList