Fungsi ExInterlockedFlushSList (wdm.h)

  • Artikel

Rutinitas ExInterlockedFlushSList secara atomik menghapus semua entri dari daftar yang ditautkan secara berurutan.

Sintaks

NTKERNELAPI
PSLIST_ENTRY
FASTCALL
ExInterlockedFlushSList (
    _Inout_ PSLIST_HEADER ListHead
    );

Parameter

[in, out] ListHead

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

Nilai kembali

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.

Keterangan

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. Driver dapat menggunakan penunjuk ini untuk melakukan iterasi melalui entri.

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

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

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
Target Platform 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