NdisInitializeListHead

VOID NdisInitializeListHead( IN PLIST_ENTRY ListHead );

NdisInitializeListHead함수는 이중 연결된 인터락된 큐,드라이버가 유지하는 인터락된 큐 혹은 이중 연결리스트를 초기화 한다.

매개변수

ListHead

인터락된 큐 혹은 리스트의 헤드에대한 드라이버가 할당한 비페이지화된 저장공간의 포인터.

주석

NdisInitializeListHead함수는 만약 드라이버가 요청들을 내부적으로 큐한다면, MiniportInitialize함수혹은 프로토콜 드라이버의 DriverEntry함수로부터 호출될수 있다. 그러나 미니포트 드라이버는 NDIS라이브러리가 요청들과 미니포트로 보내진 패킷들을 직렬화하기때문에 좀처럼 내부적인 큐들을 설정하지 않는다.

내부적인 큐를 유지하는 어떤 NDIS드라이버는 큐화된 엔트리들에 동기적인 드라이버 함수들의 접근들에 대한 책임을 진다. NdisInterlocked..List함수들은 드라이버가 멀티 프로세서 머신에서 동작한다 할지라도 단지 하나의 드라이버함수가 어떤 주어진 순간에 큐된 엔트리들을 접근할수 있다는것을 확실히한다. 왜냐하면 큐는 호출자 제공 스핀 락에의해 보호되어지기때문에.

인터락된 큐에대해, 드라이버는 또한 스핀락에대해 비페이지화된 저장장소를 제공한다. 그 스핀락에대한 NdisInterlocked..List함수들에게 포인터를 넘기기 전에 NdisAllocateSpinLock함수로 스핀락을 초기화 해야만 한다.

NdisInitializeListHead함수의 호출자는 일반적으로 IRQL PASSIVE_LEVEL에서 동작한다. 왜냐하면, 이 함수는 일반적으로 초기화에서 호출된다.