IofCallDriver 함수(wdm.h)

아티클
03/10/2023

주의

대신 IoCallDriver 를 호출합니다.

지정된 디바이스 개체와 연결된 드라이버에 IRP를 보냅니다.

구문

NTSTATUS IofCallDriver(
  PDEVICE_OBJECT        DeviceObject,
  __drv_aliasesMem PIRP Irp
);

매개 변수

DeviceObject

요청된 I/O 작업의 대상 디바이스를 나타내는 디바이스 개체에 대한 포인터입니다.

Irp

IRP에 대한 포인터입니다.

반환 값

적절한 NTSTATUS 값을 반환합니다.

설명

IoCallDriver를 호출하기 전에 호출 드라이버는 대상 드라이버에 대한 IRP에서 I/O 스택 위치를 설정해야 합니다. 자세한 내용은 드라이버 스택 아래로 IRP 전달을 참조하세요.

IoCallDriver는 호출되는 드라이버에 대한 IO_STACK_LOCATION 구조체의 DeviceObject 멤버에 DeviceObject 입력 매개 변수를 할당합니다.

상위 수준 드라이버가 IRP에 대한 IoCompletion 루틴을 설정하기 위해 IoSetCompletionRoutine을 호출하지 않는 한 IoCallDriver에 대한 호출에서 전달된 IRP는 상위 수준 드라이버에 액세스할 수 없게 됩니다. 있는 경우 IoCompletion 루틴에 대한 IRP 입력에는 하위 드라이버에서 설정한 I/O 상태 블록이 있으며 모든 하위 수준 드라이버의 I/O 스택 위치는 0으로 채워집니다.

Windows Server 2003, Windows XP 및 Windows 2000용 드라이버는 전원 IRP(IRP_MJ_POWER)를 전달하기 위해 IoCallDriver 대신 PoCallDriver를 사용해야 합니다.

자세한 내용은 IoCallDriver 호출 및 PoCallDriver 호출을 참조하세요.

요구 사항

요구 사항	값
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	IRQL <= DISPATCH_LEVEL
DDI 규정 준수 규칙	CompleteRequestStatusCheck, CompletionRoutineRegistered, DeleteDevice, ForwardedAtBadIrql, ForwardedAtBadIrqlAllocate, ForwardedAtBadIrqlFsdAsync, ForwardedAtBadIrqlFsdSync, HwStorPortProhibitedDDDIs(storport), IoAllocateForward, IoAllocateIrpSignalEventInCompletionTimeout, IoBuildDeviceControlWait, IoBuildDeviceControlWaitTimeout, IoBuildFsdForward, IoBuildSynchronousFsdRequestWait, IoBuildSynchronousFsdRequestWaitTimeout, IoSetCompletionRoutineExCheck, IrpProcessingComplete, LowerDriverReturn, MarkDevicePower, MarkQueuedIrps, MarkIrpPending, MarkIrpPending2, MarkPower(wdm), MarkPowerDown(wdm), MarkQueryRelations(wdm), MarkStartDevice(wdm), PendedCompletedRequest, PendedCompletedRequest2, PendedCompletedRequest3, PendedCompletedRequestEx, PnpIrpCompletion, PowerDownFail, PowerUpFail, RemoveLockForward, RemoveLockForward2, RemoveLockForwardDeviceControl, RemoveLockForwardDeviceControl2, RemoveLockForwardDeviceControlInternal, RemoveLockForwardDeviceControlInternal2, RemoveLockForwardRead, RemoveLockForwardRead2, RemoveLockForwardWrite, RemoveLockForwardWrite2, RemoveLockMnRemove2, RemoveLockMnSurpriseRemove, RemoveLockQueryMnRemove, TargetRelationNeedsRef, WmiForward