NdisInterlockedPopEntrySList

PSINGLE_LIST_ENTRY NdisInterlockedPopEntrySList( IN PSLIST_HEADER ListHead, IN PKSPIN_LOCK Lock );

NdisInterlockedPopEntrySList함수는 순서화된 하나의 연결리스트로부터 처음 엔트리를 제거한다.

매개변수

ListHead

엔트리가 리턴되어지는것으로부터 이미 초기화된 순서화된 하나의 연결리스트의 헤드의 포인터.

Lock

호출자에의해 현재 소유되어지지 않는 호출자 제공 스핀락의 포인터.

리턴값

NdisInterlockedPopEntrySList함수는 리스트내의 처음 엔트리에대한 포인터를 리턴한다. 만약 리스트가 비었다면, 이 루틴은 NULL을 리턴한다.

주석

드라이버는 NdisInterlockedPopEntrySList함수를 호출할때 주어진 락을 소유하고있으면 안된다. 만약 필요하다면, 드라이버는 이 호출을 만들기전에 NdisFreeSpinLock함수를 호출해야만 한다. NdisInterlockedPopEntrySList함수 그 자체는 멀티프로세서-safe방법에서도 S-List내의 처음 엔트리를 제거하기위해 이 스핀락을 허용해야만한다.

호출자는 Lock에대한 어떤 NdisInterlocked..SList루틴에대한 초기 호출전에 NdisAllocateSpinLock함수로 초기화 되어져야만하는 상주 저장장소를 제공해야만한다.

NdisInterlockedPopEntrySList함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작할수 있어야만 한다.