Функция PopEntryList (wdm.h)
Подпрограмма PopEntryList удаляет первую запись из последовательно связанного списка SINGLE_LIST_ENTRY структур.
Синтаксис
PSINGLE_LIST_ENTRY PopEntryList(
[in, out] PSINGLE_LIST_ENTRY ListHead
);
Параметры
[in, out] ListHead
Указатель на структуру SINGLE_LIST_ENTRY , представляющую главу списка. При возврате ListHead-Next> указывает на начало списка с удалением первой записи.
Возвращаемое значение
PopEntryList возвращает указатель на запись, удаленную из списка, или значение NULL , если список в настоящее время пуст.
Комментарии
PopEntryList удаляет первую запись из списка, устанавливая параметр ListHead-Next> для указания на вторую запись в списке.
Сведения об использовании этой процедуры при реализации единого связанного списка см. в статье Singly и Doubly Linked Списки.
Вызывающие функции PopEntryList могут выполняться в любом irQL. Если popEntryList вызывается по адресу IRQL >= DISPATCH_LEVEL, хранилище для ListHead и записей списка должно быть резидентным.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно начиная с Windows 2000. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h) |
| IRQL | Любой уровень (см. раздел "Примечания") |