Функция RemoveHeadList (wdm.h)

Статья
02/27/2024

Подпрограмма RemoveHeadList удаляет запись из начала удвоительно связанного списка LIST_ENTRY структур.

Синтаксис

PLIST_ENTRY RemoveHeadList(
  [in, out] PLIST_ENTRY ListHead
);

Параметры

[in, out] ListHead

Указатель на структуру LIST_ENTRY , которая служит заголовком списка.

Возвращаемое значение

RemoveHeadList возвращает указатель на запись, удаленную из списка. Если список пуст, Функция RemoveHeadList возвращает listHead.

RemoveHeadList удаляет первую запись из списка, задав параметр ListHead-Flink> так, чтобы он указывал на вторую запись в списке. Подпрограмма устанавливает элемент Blink второй записи в значение ListHead. В случае, если список пуст, это фактически не является операцией.

Сведения об использовании этой процедуры при реализации списка с удвояющими ссылками см. в статье Singly и Doubly Linked Списки.

Вызывающие функции RemoveHeadList могут выполняться в любом irQL. Если метод RemoveHeadList вызывается по адресу IRQL >= DISPATCH_LEVEL, хранилище для ListHead и записей списка должно быть резидентным.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 2000.
Целевая платформа	Персональный компьютер
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
IRQL	Любой уровень (см. раздел "Примечания")
Правила соответствия DDI	CancelSpinLock(wdm), CompleteRequest(wdm), DoubleCompletion(wdm), DoubleExFreePool(storport), Init_NdisAllocateIoWorkItem(ndis), InvalidReqAccessLocal(kmdf), IoAllocateFree(wdm), IoReuseIrp(wdm), IrpProcessingComplete(wdm), MarkInterlockedQueuedIrps(wdm), MarkQueuedIrps(wdm), MarkIrpPending(wdm), MarkIrpPending2(wdm), PendedCompletedRequest(wdm), PendedCompletedRequest2(wdm), PendedCompletedRequest3(wdm), PendedCompletedRequestEx(wdm), RemoveLock(wdm), RemoveLockCheck(wdm), RemoveLockForward(wdm), RemoveLockForward2(wdm), RemoveLockForwardDeviceControl(wdm), RemoveLockForwardDeviceControl2(wdm), RemoveLockForwardDeviceControlInternal(wdm), RemoveLockForwardDeviceControlInternal2(wdm), RemoveLockForwardRead(wdm), RemoveLockForwardRead2(wdm), RemoveLockForwardWrite(wdm), RemoveLockForwardWrite2(wdm), RemoveLockMnRemove(wdm), RemoveLockMnSurpriseRemove(wdm), RemoveLockRelease2(wdm), RemoveLockReleaseCleanup(wdm), RemoveLockReleaseClose(wdm), RemoveLockReleaseCreate(wdm), RemoveLockReleaseDeviceControl(wdm), RemoveLockReleaseInternalDeviceControl(wdm), RemoveLockReleasePnp(wdm), RemoveLockReleasePower(wdm), RemoveLockReleaseRead(wdm), RemoveLockReleaseShutdown(wdm), RemoveLockReleaseSystemControl(wdm), RemoveLockReleaseWrite(wdm)