Condividi tramite


Funzione InsertHeadList (wdm.h)

La routine InsertHeadList inserisce una voce all'inizio di un elenco doubly collegato di strutture LIST_ENTRY.

Sintassi

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

Parametri

[in, out] ListHead

Puntatore alla struttura LIST_ENTRY che rappresenta l'intestazione dell'elenco.

[in, out] Entry

Puntatore a una struttura LIST_ENTRY che rappresenta la voce da inserire nell'elenco.

Valore restituito

Nessuno

Osservazioni

gli aggiornamenti di InsertHeadList ListHead-> Flink puntano aEntry . Aggiorna Entry:>Flink in modo che punti alla prima voce precedente nell'elenco e imposta Entry->Blink su ListHead. Anche il campo lampeggia della prima voce originale viene aggiornato in modo da puntare a Voce.

Per informazioni sull'uso di questa routine durante l'implementazione di un elenco collegato doubly, vedere Elenchi collegati doubly e Doubly.

I chiamanti di insertHeadList possono essere eseguiti in qualsiasi IRQL. Se InsertHeadList viene chiamato in IRQL >= DISPATCH_LEVEL, la risorsa di archiviazione per listHead e le voci dell'elenco devono essere residenti.

Fabbisogno

Requisito Valore
client minimo supportato Disponibile a partire da Windows 2000.
piattaforma di destinazione Desktop
intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
IRQL Qualsiasi livello (vedere la sezione Osservazioni)
regole di conformità 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)

Vedere anche

exInterlockedInsertHeadList

InitializeListHead

insertTailList

IsListEmpty

RemoveHeadList

RemoveTailList