Fungsi ExInterlockedFlushSList (wdm.h)

Artikel
07/02/2025

ExInterlockedFlushSList rutin secara atom menghapus semua entri dari daftar yang ditautkan secara berurutan.

Sintaksis

C++

NTKERNELAPI
PSLIST_ENTRY
FASTCALL
ExInterlockedFlushSList (
    _Inout_ PSLIST_HEADER ListHead
    );

Parameter

[in, out] ListHead

Penunjuk ke struktur SLIST_HEADER yang berfungsi sebagai header untuk daftar tertaut berurutan.

Mengembalikan nilai

Jika ada entri pada daftar yang ditentukan, ExInterlockedFlushSList mengembalikan penunjuk ke struktur SLIST_ENTRY pertama yang merupakan entri dalam daftar; jika tidak, ia mengembalikan NULL.

Komentar

ExInterlockedFlushSList tidak menghapus struktur SLIST_ENTRY yang membentuk daftar; ini hanya mengatur penunjuk internal ListHead ke awal daftar ke NULL. Driver harus membebaskan entri secara eksplisit.

Rutinitas mengembalikan penunjuk ke struktur SLIST_ENTRY pertama yang ada dalam daftar. Pengandar dapat menggunakan penunjuk ini untuk melakukan iterasi melalui entri.

Untuk informasi selengkapnya tentang menggunakan rutinitas ini untuk mengimplementasikan daftar yang ditautkan secara berurutan, lihat Daftar Tertaut Singly dan Doubly.

Penelepon ExInterlockedFlushSList dapat berjalan di IRQL apa pun. Penyimpanan untuk parameter ListHead dan entri daftar harus residen di semua IRQL.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Tersedia dimulai dengan Windows 2000.
Platform Target	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Tingkat apa pun (lihat bagian Keterangan)

Lihat juga

ExInitializeSListHead

Bagikan melalui