NdisScheduleWorkItem

NDIS_STATUS NdisScheduleWorkItem( IN PNDIS_WORK_ITEM WorkItem );

NdisScheduleWorkItem 함수는 시스템 작업자 스레드가 아이템을 제거한 큐안으로 주어진 작업 아이템을 삽입하고 전에 드라이버가 NdisInitializeWorkItem 함수호출로 제공한 콜백함수로 제어를 준다.

매개변수

WorkItem

NdisInitializeWorkItem 함수로의 앞선 호출에서 설정된 작업 아이템을 가리킨다.

주석

NdisScheduleWorkItem 함수로의 호출은 NDIS 드라이버로 하여금 몇몇 드라이버 결정연산을 지연하도록 한다. 드라이버 결정연산은 작업자 스레드 콜백함수에서 현재 실행되는 상승된 IRQL보다 더 낮은 IRQL에서 실행되어야한다.

드라이버의 콜백은 나중에 IRQL PASSIVE_LEVEL에서 시스템 스레드 컨텍스트 안에서 실행된다. 이 호출자 제공 함수는 WorkItem을 위해서 드라이버가 할당한 저장소의 회수에 책임을 진다. 예를들어, 드라이버가 NdisInitializeWorkItem 함수에 대한 컨텍스트 지역을 제공하기 위해서 NdisAllocateMemory 함수를 호출한다면 그것의 콜백함수는 통제를 리턴하기 전에 WorkItem을 가지고 NdisFreeMemory 함수로 상반된 호출을 해야한다.

드라이버가 하나의 동기화 객체를 유지하고 있고 또다른 동기화 객체를 얻으려고 시도한다면 드라이버는 연산을 완료하는 콜백루틴에 대해서 기다릴 필요가 없다. 예를들어, NDIS 드라이버는 NdisScheduleWorkItem 함수를 호출하기전에 현재 유지하는 스핀락을 해제해야한다. 최상위 레벨 NDIS 프로토콜 드라이버는 또한 NdisScheduleWorkItem 함수를 호출하기 전에 현재 유지하고 있는 세마포어, 뮤텍스, 변수자원들을 해제해야한다. 동기적인 작업자 스레드 연산을 큐에 저장하기 전에 모든 동기화 자원을 해제하는 것은 교착상태를 방지한다.

직렬화된 미니포트 드라이버는 작업자 스레드 콜백루틴을 큐에 저장하지 말아야한다. 왜냐하면 작업자 스레드 콜백을 가진 NIC 컨텍스트 지역으로의 접근을 동기화하기 위해서 드라이버는 방법이 없기 때문이다. 결과적으로 그러한 직렬화된 NDIS 드라이버는 시스템의 파괴없이 작업자 스레드 콜백함수를 가진 어댑터당 컨텍스트 지역에서 아무것도 공유할 수 없다.

NdisScheduleWorkItem 함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 실행되어야한다.