KeInitializeSpinLock 例程初始化KSPIN_LOCK类型的变量。
语法
void KeInitializeSpinLock(
[out] PKSPIN_LOCK SpinLock
);
参数
[out] SpinLock
指向旋转锁的指针,调用方必须提供存储。
返回值
没有
言论
必须先调用此例程,然后才能调用 KeAcquireSpinLock、KeAcquireInStackQueuedSpinLock或需要旋转锁作为参数的任何其他支持例程。
旋转锁对象的存储必须驻留:在驱动程序创建的设备对象的设备扩展、驱动程序创建的控制器对象的控制器扩展或调用方分配的非分页池中。
此函数针对从 Windows XP 到 Windows 7 的 x64 系统内联。 从 Windows 8 开始,此函数从 ntoskrnl.lib
导出。 因此,如果使用 Windows 10 WDK 生成在 Windows 7 上运行的二进制文件(因此需要 NX 池使用情况才能通过 Windows 10 HLK 测试),则必须定义 WIN9X_COMPAT_SPINLOCK
。 否则,你可能会看到 Windows cannot load the device driver for this hardware. The driver may be corrupted or missing. (Code 39)
。
有关旋转锁的详细信息,请参阅 旋转锁。
此例程的调用方可以在任何 IRQL 上运行。 通常,调用方在 IRQL = PASSIVE_LEVEL AddDevice 例程中运行。
要求
要求 | 价值 |
---|---|
目标平台 | 普遍 |
标头 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
库 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | 任何级别 (请参阅“备注”部分) |
DDI 符合性规则 | HwStorPortProhibitedDIS(storport) |
另请参阅
KeAcquireInStackQueuedSpinLock
KeAcquireInStackQueuedSpinLockAtDpcLevel
KeReleaseInStackQueuedSpinLock