NdisInterlockedPushEntrySList マクロ (ndis.h)

[アーティクル]
03/05/2024

NdisInterlockedPushEntrySList 関数は、一連の一連のリンクリストの先頭にエントリを挿入します。

構文

void NdisInterlockedPushEntrySList(
        SListHead,
        SListEntry,
  [in]  Lock
);

パラメーター

SListHead

既に初期化されているシーケンス化された、指定したエントリを挿入する 1 つのリンクリストの先頭へのポインター。

SListEntry

挿入するエントリへのポインター。

[in] Lock

呼び出し元が現在保持していない、呼び出し元が指定したスピンロックへのポインター。

戻り値

なし

解説

ドライバーが NdisInterlockedPushEntrySList 関数を最初に呼び出す前に、を使用してリストヘッドを初期化する必要があります。 NdisInitializeSListHead 関数。

NdisInterlockedPushEntrySList を呼び出すとき、ドライバーは指定された Lock を保持してはなりません。必要に応じて、ドライバーは NdisInterlockedPushEntrySList を呼び出す前に NdisReleaseSpinLock 関数を呼び出す必要があります。 NdisInterlockedPushEntrySList は、リストの先頭に ListEntry を挿入する前に、このロック自体を取得して、この操作がマルチプロセッサセーフな方法で処理されるようにする必要があります。

呼び出し元 は Lock の常駐ストレージを提供する必要があります。これは、NdisInterlocked への最初の呼び出しの前に NdisAllocateSpinLock 関数で初期化する必要があります 。SList ルーチン。

I/O 操作を再試行するドライバーでは、二重にリンクされたインターロックされたキューと NdisInterlockedInsert/Remove を使用する必要があります。S-List の代わりに関数を一覧表示します。

IRQL >= DISPATCH_LEVELで NdisInterlockedPushEntrySList が呼び出された場合、ListHead パラメーターとリストエントリのストレージは常駐である必要があります

要件

要件	値
サポートされている最小のクライアント	Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisInterlockedPushEntrySList (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisInterlockedPushEntrySList (NDIS 5.1)」を参照) でサポートされています。
対象プラットフォーム	デスクトップ
Header	ndis.h (Ndis.h を含む)
IRQL	任意のレベル