Função ExInterlockedRemoveHeadList (wdm.h)
A rotina ExInterlockedRemoveHeadList remove uma entrada do início de uma lista duplamente vinculada de estruturas LIST_ENTRY .
Sintaxe
PLIST_ENTRY ExInterlockedRemoveHeadList(
[in, out] PLIST_ENTRY ListHead,
[in, out] PKSPIN_LOCK Lock
);
Parâmetros
[in, out] ListHead
Um ponteiro para a estrutura LIST_ENTRY que serve como o cabeçalho da lista.
[in, out] Lock
Um ponteiro para uma estrutura KSPIN_LOCK que serve como o bloqueio de rotação usado para sincronizar o acesso à lista. O armazenamento do bloqueio de rotação deve ser residente e deve ter sido inicializado chamando KeInitializeSpinLock. Você deve usar esse bloqueio de rotação somente com as rotinas da ListaXxxExInterlocked .
Retornar valor
ExInterlockedRemoveHeadList retorna um ponteiro para a estrutura LIST_ENTRY removida da lista. Se a lista estiver vazia, a rotina retornará NULL.
Comentários
ExInterlockedRemoveHeadList executa uma operação semelhante a RemoveHeadList, mas atomicamente. Não misture chamadas atômicas e não atômicas na mesma lista.
Para obter mais informações sobre como usar essa rotina para implementar uma lista duplamente vinculada, consulte Singly e Doubly Linked Listas.
A rotina ExInterlockedRemoveHeadList pode ser chamada em qualquer IRQL. O armazenamento do parâmetro ListHead deve ser residente em todas as IRQLs.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 2000. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Qualquer nível (consulte a seção Comentários) |