NdisInterlockedPushEntrySList 巨集（ndis.h）

發行項
02/07/2025

NdisInterlockedPushEntrySList 函式會在循序、單選連結清單的前端插入專案。

語法

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

參數

SListHead

已初始化之已初始化之已排序、單聲連結清單的指標，指定要插入的指定專案。

SListEntry

要插入之專案的指標。

[in] Lock

呼叫端所提供微調鎖定的指標，目前不是由呼叫端所持有。

傳回值

沒有

言論

在驅動程式初始呼叫 NdisInterlockedPushEntrySList 函式之前，它必須使用初始化清單標頭 NdisInitializeSListHead 函式。

驅動程式在呼叫 NdisInterlockedPushEntrySList時，不得保留指定的鎖定。如有必要，驅動程式必須先呼叫 NdisReleaseSpinLock 函式，才能呼叫 NdisInterlockedPushEntrySList。 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）。支援 NDIS 5.1 驅動程式（請參閱 Windows XP 中的 NdisInterlockedPushEntrySList （NDIS 5.1）。
目標平臺	桌面
標頭	ndis.h （包括 Ndis.h）
IRQL	任何層級