NdisInterlockedRemoveHeadList

PLIST_ENTRY NdisInterlockedRemoveHeadList( IN PLIST_ENTRY ListHead, IN PNDIS_SPIN_LOCK SpinLock );

NdisInterlockedRemoveHeadList함수는 이중연결된 리스트의 엔트리, 일반적으로 패킷,를 제거하여 리스트에대한 접근이 멀티프로세서-safe방법에서 동기적으로 되도록 한다.

매개변수

ListHead

엔트리가 제거되어지는것으로부터 이중연결된 리스트의 헤드의 포인터.

SpinLock

리스트에 동기적으로 접근하기위해 사용되는, 호출자 할당 스핀 락의 포인터.

리턴값

NdisInterlockedRemoveHeadList함수는 de큐되는 엔트리의 포인터를 리턴한다. 만약 리스트가 비었다면, NULL을 리턴한다.

주석

어떤 NdisInterlocked..List함수를 호출하기전에, 드라이버는 NdisInitializeListHead함수로 ListHead변수를 초기화 해야만 하고 NdisAllocateSpinLock함수로 SpinLock변수를 초기화 해야만 한다. 드라이버는 또한 이런한 변수들과 내부 큐에대한 상주 공간을 제공해야만한다.

NdisInterlockedRemoveHeadList함수를 호출하기전에, 엔트리들은 NdisInterlockedInsert..List함수의 한번혹은 그이상의 호출로 큐화해야한다.

호출자 제공 스핀락은 NdisInterlockedRemoveHeadList함수가 엔트리를 제거하는동안 드라이버의 내부 큐에 접근하는것으로부터 어떤 다른 함수들을 막는다. 심지어 드라이버가 멀티프로세서 머신에서 동작할때조차.

NdisInterlockedRemoveHeadList함수는 주어진 스핀락을 허용할때 IRQL을 DISPATCH_LEVEL까지 올리고 컨추럴을 리턴하기전에 원래 IRQL을 저장한다. 결과적으로, NdisInterlockedRemoveHeadList함수를 호출하는 어떤 드라이버함수는 페이져블한 코드일수 없다.

리턴된 값을 삽입된 엔트리의 어드레스로 다시 바꾸기위해, 드라이버는 CONTAINING_RECORD메크로를 사용할수 있다(Kernel-Mode Driver Reference를 보라).

NdisInterlockedRemoveHeadList함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작한다.