ExInterlockedPushEntryList 함수(wdm.h)
ExInterlockedPushEntryList 루틴은 SINGLE_LIST_ENTRY 구조체의 singly 연결된 목록의 시작 부분에 항목을 원자적으로 삽입합니다.
구문
PSINGLE_LIST_ENTRY ExInterlockedPushEntryList(
[in, out] PSINGLE_LIST_ENTRY ListHead,
[in, out] __drv_aliasesMem PSINGLE_LIST_ENTRY ListEntry,
[in, out] PKSPIN_LOCK Lock
);
매개 변수
[in, out] ListHead
목록 헤더 역할을 하는 SINGLE_LIST_ENTRY 구조체에 대한 포인터입니다. ListHead의 스토리지는 모든 IRQL에 상주해야 합니다.
[in, out] ListEntry
목록에 삽입할 항목을 나타내는 SINGLE_LIST_ENTRY 구조체에 대한 포인터입니다. ListEntry에 대한 스토리지는 모든 IRQL에 상주해야 합니다.
[in, out] Lock
목록에 대한 액세스를 동기화하는 데 사용되는 스핀 잠금 역할을 하는 KSPIN_LOCK 구조체에 대한 포인터입니다. 스핀 잠금에 대한 스토리지는 상주해야 하며 KeInitializeSpinLock을 호출하여 초기화되어야 합니다. ExInterlockedXxx목록 루틴에서만 이 스핀 잠금을 사용해야 합니다.
반환 값
ExInterlockedPushEntryList 는 새 항목이 삽입되기 전에 목록의 첫 번째 항목에 대한 포인터를 반환합니다. 목록이 비어 있으면 루틴은 NULL을 반환합니다.
설명
ExInterlockedPushEntryList 는 PushEntryList와 동일한 작업을 수행하지만 원자성으로 수행합니다. 동일한 목록에서 원자성 및 비원자성 호출을 혼합하지 마세요.
이 루틴을 사용하여 Singly 연결된 목록을 구현하는 방법에 대한 자세한 내용은 Singly 및 Doubly Linked Lists 참조하세요.
ExInterlockedPushEntryList 루틴은 모든 IRQL에서 호출할 수 있습니다. ListHead 매개 변수 및 목록 항목에 대한 스토리지는 모든 IRQL에 상주해야 합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000부터 사용할 수 있습니다. |
대상 플랫폼 | 유니버설 |
헤더 | wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함) |
라이브러리 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | 모든 수준(설명 섹션 참조) |
DDI 규정 준수 규칙 | IoAllocateFree(wdm), IoReuseIrp(wdm), MarkingInterlockedQueuedIrps(wdm), RemoveLockCheck(wdm), RemoveLockForward(wdm), RemoveLockForward2(wdm), RemoveLockForwardDeviceControl(wdm), RemoveLockForwardDeviceControl2(wdm), RemoveLockForwardDeviceControlInternal(wdm), RemoveLockForwardDeviceControlInternal2(wdm), RemoveLockForwardRead(wdm), RemoveLockForwardRead2(wdm), RemoveLockForwardWrite(wdm), RemoveLockForwardWrite2(wdm), RemoveLockRelease2(wdm), RemoveLockReleaseCleanup(wdm), RemoveLockReleaseClose(wdm), RemoveLockReleaseCreate(wdm), RemoveLockReleaseDeviceControl(wdm), RemoveLockReleaseInternalDeviceControl(wdm), RemoveLockReleasePower(wdm), RemoveLockReleaseShutdown(wdm), RemoveLockReleaseSystemControl(wdm), RemoveLockReleaseWrite(wdm) |