NdisInitializeWorkItem

VOID NdisInitializeWorkItem( IN PNDIS_WORK_ITEM WorkItem, IN NDIS_PROC Routine, IN PVOID Context );

NdisInitializeWorkItem함수는 호출자 제공 컨텍스트와 시스템 작업자 스레드가 컨트롤에게 주어질때 실행에대해 큐되어지는 콜백루틴로 작업-큐를 초기화 한다.

매개변수

WorkItem

초기화 되어지는 호출자 제공 저장장소의 포인터. 비페이지화된 pool로부터 할당되어져야만한다.

Routine

de큐되었을때 이 작업 아이템을 처리하는 호출자 제공 함수의 엔트리 포인트를 지정한다. 이 콜백은 다음과 같이 선언되었다.:

VOID

(*NDIS_PROC)(

    IN struct _NDIS_WORK_ITEM *  pWorkItem,

    IN PVOID  Context

);

Context

유일한 파라미터로써 콜백에게 넘겨지고 해석되어지지않는 호출자 제공 컨텍스트 영역의 포인트. 이 영역은 상주 메모리내에 있어야만 하고 콜백이 순차적으로 동작될지 모르는 임의의 스레드 영역내에 접근할수 있어야만 한다. 특히, Context는 스택을 가릴킬수 없다.

주석

NdisInitializeWorkItem함수는 Routine 과 Context 과 NULL 리스트 포인터로 Item을 초기화 한다.

일반적으로, 유일한 높은 레벨 드라이버들은 작업자 스레스 아이템들을 큐한다.

비직렬화되지않고 연결지향이 아닌 닉 미니포트는 Ndis..WorkItem함수를 호출해서는 안된다.

주어진 Routine은 Item에대한 저장장소를 해제하기위해 NdisFreeMemory함수의 호출에대한 책임을 진다.

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