ExInterlockedFlushSList 関数 (wdm.h)

ExInterlockedFlushSList ルーチンは、シーケンスされた 1 つのリンクリストからすべてのエントリをアトミックに削除します。

構文

NTKERNELAPI
PSLIST_ENTRY
FASTCALL
ExInterlockedFlushSList (
    _Inout_ PSLIST_HEADER ListHead
    );

[in, out] ListHead

シーケンスされた 1 つのリンクリストのヘッダーとして機能する SLIST_HEADER 構造体へのポインター。

指定したリストにエントリがある場合、exInterlockedFlushSList は、リストのエントリであった最初の SLIST_ENTRY 構造体へのポインターを返します。それ以外の場合は NULL を返します。

ExInterlockedFlushSList 、リストを構成する SLIST_ENTRY 構造体は削除されません。これは、listHead の内部ポインターをリストの先頭に設定するだけで、NULL をします。ドライバーは、エントリを明示的に解放する必要があります。

このルーチンは、リストにあった最初の SLIST_ENTRY 構造体へのポインターを返します。ドライバーは、このポインターを使用してエントリを反復処理できます。

このルーチンを使用してシーケンスされた 1 つのリンクリストを実装する方法の詳細については、「Singly および Doubly Linked Listsを参照してください。

ExInterlockedFlushSList の呼び出し元は、任意の IRQL で実行できます。 ListHead パラメーターとリストエントリのストレージは、すべての IRQL に常駐している必要があります。