ExInterlockedFlushSList 関数 (wdm.h)

ExInterlockedFlushSList ルーチンは、一連の個別にリンクされたリストからすべてのエントリをアトミックに削除します。

構文

NTKERNELAPI
PSLIST_ENTRY
FASTCALL
ExInterlockedFlushSList (
    _Inout_ PSLIST_HEADER ListHead
    );

[in, out] ListHead

SLIST_HEADER 構造へのポインター。これは、1 つの順序でリンクされたリストのヘッダーとして機能します。

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

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

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

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

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