WdfDeviceWdmDispatchIrp 함수(wdfdevice.h)

[KMDF 및 UMDF에 적용]

WdfDeviceWdmDispatchIrp 메서드는 EvtDeviceWdmIrpDispatch에서 프레임워크에 디스패치된 IRP를 반환합니다.

구문

NTSTATUS WdfDeviceWdmDispatchIrp(
  [in] WDFDEVICE  Device,
  [in] PIRP       Irp,
  [in] WDFCONTEXT DispatchContext
);

매개 변수

[in] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

[in] Irp

IRP 구조체에 대한 포인터입니다.

[in] DispatchContext

드라이버가 EvtDeviceWdmIrpDispatch 콜백에서 받은 디스패치 컨텍스트 매개 변수입니다.

반환 값

WdfDeviceWdmDispatchIrp 메서드는 IRP 처리 결과로 프레임워크 또는 드라이버가 제공하는 NTSTATUS 값을 반환합니다. 드라이버는 WdfDeviceWdmDispatchIrp이라는 EvtDeviceWdmIrpDispatch 콜백 함수의 반환 값으로 이 반환 값을 사용해야 합니다.

KMDF 드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다. UMDF 드라이버가 잘못된 핸들을 제공하면 드라이버 호스트 프로세스가 종료됩니다.

설명

드라이버가 EvtDeviceWdmIrpDispatch 콜백 함수를 제공하는 경우 콜백 함수 내에서 WdfDeviceWdmDispatchIrp 을 호출하여 IRP를 특정 큐로 디스패치하는 대신 기본 처리를 위해 프레임워크로 반환할 수 있습니다.

IRP가 도착할 때 큐를 지정하는 방법에 대한 자세한 내용은 I/O 큐에 IRP 디스패치를 참조하세요.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.11
최소 UMDF 버전	2.17
머리글	wdfdevice.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL	<= DISPATCH_LEVEL
DDI 규정 준수 규칙	DriverCreate(kmdf)

추가 정보

EvtDeviceWdmIrpDispatch

WdfDeviceWdmDispatchIrpToIoQueue