NdisInterlockedInsertTailList

PLIST_ENTRY NdisInterlockedInsertTailList( IN PLIST_ENTRY ListHead, IN PLIST_ENTRY ListEntry, IN PNDIS_SPIN_LOCK SpinLock );

NdisInterlockedInsertTailList함수는 엔트리,일반적으로 패킷을 이중연결리스트의 테일에 삽입하여 멀티프로세서-safe방법으로 동기화되는 리스트에 접근하도록 한다.

매개변수

ListHead

엔트리가 삽입되어지는 이중연결리스트의 테일의 포인터.

ListEntry

리스트의 끝에 삽입되어지는 엔트리의 포인트

SpinLock

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

리턴값

NdisInterlockedInsertTailList함수는 주어진 엔트리가 삽입되기전에 큐의 테일에 있는 엔트리에대한 포인터를 리턴한다. 만약 큐가 비었다면, NULL을 리턴한다.

주석

NdisInterlockedInsertTailList함수의 호출전에, 드라이버는 NdisInitializeListHead함수로 ListHead의 변수를 초기화 해야만하고 NdisAllocateSpinLock함수로 SpinLock의 변수를 초기화해야만 한다. 드라이버는 이러한 변수들에대한 그리고 내부 큐에대한 상주 저장장소를 제공해야만한다.

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

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

리턴된 값을 삽입된 엔트리로 다시 변환하기위해, 드라이버는 CONTAINING_RECORD매크로를 사용한다(Kernel-Mode Driver Reference를보라).

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