Função InsertHeadList (wdm.h)

Artigo
02/07/2025

A rotina InsertHeadList insere uma entrada à frente de uma lista duplamente vinculada de estruturas LIST_ENTRY.

Sintaxe

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

Parâmetros

[in, out] ListHead

Ponteiro para a estrutura de LIST_ENTRY que representa o cabeçalho da lista.

[in, out] Entry

Ponteiro para uma estrutura de LIST_ENTRY que representa a entrada a ser inserida na lista.

Valor de retorno

Nenhum

Observações

insertHeadList atualizações listhead-> Flink para apontar para de entrada de. Ele atualiza de Entrada –> Flink para apontar para a primeira entrada antiga da lista e define de Entrada –> Blink para ListHead. O campo Blink da primeira entrada original também é atualizado para apontar para de Entrada.

Para obter informações sobre como usar essa rotina ao implementar uma lista duplamente vinculada, consulte Listas Vinculadas Singly e Doubly.

Os chamadores de InsertHeadList podem estar em execução em qualquer IRQL. Se InsertHeadList for chamado em IRQL >= DISPATCH_LEVEL, o armazenamento para ListHead e as entradas de lista deverão ser residentes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 2000.
da Plataforma de Destino	Área de trabalho
cabeçalho	wdm.h (incluem Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
IRQL	Qualquer nível (seção Ver Comentários)
regras de conformidade de DDI	IoAllocateFree(wdm), IoReuseIrp(wdm), MarkingQueuedIrps(wdm), Remove, 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, RemoveLockReleaseRead(wdm), RemoveLockReleaseShutdown(wdm), RemoveLockReleaseSystemControl(wdm), RemoveLockReleaseWrite(wdm)