FltQueueGenericWorkItem 함수(fltkernel.h)

FltQueueGenericWorkItem 은 특정 I/O 작업과 연결되지 않은 작업 항목을 작업 큐에 게시합니다.

구문

NTSTATUS FLTAPI FltQueueGenericWorkItem(
  [in]           PFLT_GENERIC_WORKITEM         FltWorkItem,
  [in]           PVOID                         FltObject,
  [in]           PFLT_GENERIC_WORKITEM_ROUTINE WorkerRoutine,
  [in]           WORK_QUEUE_TYPE               QueueType,
  [in, optional] PVOID                         Context
);

매개 변수

[in] FltWorkItem

작업 큐에 추가할 작업 항목에 대한 포인터입니다. FltAllocateGenericWorkItem을 호출하여 작업 항목을 할당해야 합니다.

[in] FltObject

호출자에 대한 불투명 필터(PFLT_FILTER) 또는 instance(PFLT_INSTANCE) 포인터입니다.

[in] WorkerRoutine

호출자가 제공한 작업자 루틴에 대한 포인터입니다. 이 루틴은 다음과 같이 선언됩니다.

typedef VOID
(*PFLT_GENERIC_WORKITEM_ROUTINE) (
 _In_ PFLT_GENERIC_WORKITEM FltWorkItem,
 _In_ PVOID FltObject,
 _In_opt_ PVOID Context
      );

FltWorkItem

제네릭 작업 항목 구조에 대한 불투명 포인터입니다.

FltObject

FltQueueGenericWorkItem의 FltObject 매개 변수로 전달된 불투명 필터 포인터입니다.

Context

FltQueueGenericWorkItem의 Context 매개 변수로 전달된 컨텍스트 정보 포인터입니다. 이 매개 변수는 선택적 요소입니다.

[in] QueueType

FltWorkItem이 가리키는 작업 항목을 삽입할 큐를 지정합니다. QueueType 은 다음 중 하나일 수 있습니다.

QueueType 값 HyperCriticalWorkQueue는 시스템 사용을 위해 예약되어 있습니다.

[in, optional] Context

WorkerRoutine 매개 변수에 지정된 콜백 루틴의 Context 매개 변수로 전달될 호출자 정의 컨텍스트 정보에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다.

반환 값

FltQueueGenericWorkItem 은 STATUS_SUCCESS 또는 다음 중 하나와 같은 적절한 NTSTATUS 값을 반환합니다.

설명

FltQueueGenericWorkItem 은 특정 I/O 작업과 연결되지 않은 작업 항목을 시스템 작업 큐에 삽입합니다. 지정된 WorkerRoutine 콜백 루틴은 IRQL PASSIVE_LEVEL 시스템 스레드의 컨텍스트에서 호출됩니다.

작업 항목을 할당하려면 FltAllocateGenericWorkItem을 호출합니다.

더 이상 필요하지 않은 작업 항목을 해제하려면 FltFreeGenericWorkItem을 호출합니다.

요구 사항

추가 정보

FltAllocateGenericWorkItem

FltFreeGenericWorkItem