NdisInitializeSListHead

VOID NdisInitializeSListHead( IN PSLIST_HEADER SListHead );

NdisInitializeSListHead함수는 일련의, 포개지는 하나의 링크드리스트를 초기화한다.

매개변수

SListHead

상주 메모리내에 있어야한는 초기화되는 호출자 제공 리스트헤드의 포인터.

주석

NdisInitializeSListHead함수는 SListHead에 모호한 리스트 헤드를 0으로 초기화하고 처음엔트리 포인터를 NULL로 설정한다.

S-List내의 일련번호는 엔트리가 리스트에 추가되거나 혹은 리스트로부터 제거될때마다 증가된다.

S-List내의 모든 엔트리들은 비페이지화되어야한다.

S-List를 사용하는 어떤 드라이버라도 NdisInterlockedPushEntrySList함수와 NdisInterlockedPopEntrySList함수에게 스핀 락을 제공해야만 한다. 이러한 함수들중의 어떤 하나의 처음호출전에, 드라이버는 NdisAllocateSpinLock함수로 스핀락을 초기화 해야만 한다. 데드락을 예방하기위해, 드라이버는 NdisInterlockedPushEntrySList함수와 NdisInterlockedPopEntrySList함수의 순차적인 호출을 만들때 이 스핀락을 잡고있어서는 안된다.

비페이지화된 메모리로부터 고정된 사이즈의 POOL을 다루기위해, S-List대신 룩어사이드 리스트의 사용을 고려한다.

I/O연산들을 재시도하는 드라이버들은 S-List보다는 이중 연결 인터락된 큐와 NdisInterlockedInsert/Remove..List함수를 사용해야만한다.

NdisInitializeSListHead함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작해야만 한다.