IoAllocateWorkItem 함수(wdm.h)

IoAllocateWorkItem 루틴은 작업 항목을 할당합니다.

구문

PIO_WORKITEM IoAllocateWorkItem(
  [in] PDEVICE_OBJECT DeviceObject
);

매개 변수

[in] DeviceObject

호출자의 드라이버 개체 또는 호출자의 디바이스 개체 중 하나에 대한 포인터입니다. 호출자가 나중에 작업 항목을 IoQueueWorkItem에 전달하는 경우 DeviceObject 는 디바이스 개체를 가리킵니다.

반환 값

IoAllocateWorkItem 은 할당된 IO_WORKITEM 구조체에 대한 포인터를 반환합니다. 충분한 리소스가 없는 경우 루틴은 NULL 을 반환합니다.

설명

드라이버는 IoFreeWorkItem을 호출하여 IoAllocateWorkItem에서 반환되는 작업 항목을 해제해야 합니다.

IoAllocateWorkItem 은 모두 작업 항목을 할당하고 초기화합니다. 관련 루틴인 IoInitializeWorkItem은 드라이버가 이전에 할당한 스토리지의 작업 항목을 초기화합니다. IoInitializeWorkItem을 호출하여 IoAllocateWorkItem에 의해 할당된 작업 항목을 초기화하지 마세요.

작업 항목에 대한 자세한 내용은 시스템 작업자 스레드를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 이상 버전의 Windows 운영 체제 및 Windows Me에서 사용할 수 있습니다. 이 루틴은 Windows 98에서 사용할 수 없습니다.
대상 플랫폼	유니버설
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

추가 정보

IO_WORKITEM

IoFreeWorkItem

IoInitializeWorkItem

IoQueueWorkItem

IoQueueWorkItemEx