NdisInitializeSListHead 宏 (ndis.h)

  • 项目

NdisInitializeSListHead 函数初始化序列、互锁、单独链接列表的头。

语法

void NdisInitializeSListHead(
  [in]  SListHead
);

参数

[in] SListHead

指向要初始化的调用方提供的列表头的指针，该头必须位于常驻内存中。 在 64 位平台上，结构必须是 16 字节对齐的。

返回值

无

备注

NdisInitializeSListHead 在 SListHead 上对不透明的列表头进行零初始化，并将第一个条目指针设置为 NULL。

每次将条目插入列表或从列表中删除条目时，S-List 中的序列号都会递增。

S-List 中的所有条目都必须是非分页的。

任何使用 S-List 的驱动程序都必须为 提供旋转锁 NdisInterlockedPushEntrySList 和 NdisInterlockedPopEntrySList 函数。 在对其中任一函数进行初始调用之前，驱动程序必须使用 NdisAllocateSpinLock 函数初始化旋转锁。 若要防止死锁，驱动程序在对 NdisInterlockedPushEntrySList 和 NdisInterlockedPopEntrySList 进行后续调用时不得持有此旋转锁。

若要管理来自非分页内存的固定大小条目的池，请考虑使用旁观列表而不是 S 列表。

重试 I/O 操作的驱动程序应使用双链接互锁队列和 NdisInterlockedInsertHeadList、 NdisInterlockedInsertTailList 和 NdisInterlockedRemoveHeadList 函数，而不是 S-List。

如果在 IRQL >= DISPATCH_LEVEL 调用 NdisInitializeSListHead，则 SListHead 参数的存储必须是驻留的。

要求

要求 值
最低受支持的客户端 NDIS 6.0 和 NDIS 5.1 驱动程序支持 (请参阅 Windows Vista 中的 NdisInitializeSListHead (NDIS 5.1) ) 。 NDIS 5.1 驱动程序支持 (请参阅 Windows XP 中的 NdisInitializeSListHead (NDIS 5.1) ) 。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
IRQL 任何级别

另请参阅

NdisInitializeNPagedLookasideList

NdisInterlockedPopEntrySList

NdisInterlockedPushEntrySList

NdisQueryDepthSList

NdisQueueIoWorkItem