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 入力パラメーターを割り当てます。

IoCallDriver への呼び出しで渡された IRP は、上位レベルのドライバーが IRP の IoCompletion ルーチンを設定するために IoSetCompletionRoutine を呼び出していない限り、上位レベルのドライバーにアクセスできなくなります。存在する場合、IoCompletion ルーチンへの IRP 入力には、下位ドライバーによって設定された I/O 状態ブロックがあり、下位レベルのすべてのドライバーの I/O スタックの場所は 0 で埋められます。

Windows Server 2003、Windows XP、および Windows 2000 用のドライバーは、電源 IRP (IRP_MJ_POWER) を渡すために IoCallDriver ではなく PoCallDriver を使用する必要があります。

詳細については、「 IoCallDriver の呼び出しと PoCallDriver の呼び出し」を参照してください。

要件

要件	値
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則	CompleteRequestStatusCheck、CompletionRoutineRegistered、DeleteDevice、ForwardedAtBadIrql、ForwardedAtBadIrqlAllocate、ForwardedAtBadIrqlFsdAsync、 ForwardedAtBadIrqlFsdSync、 HwStorPortProhibitedDDIs(storport)、IoAllocateForward、IoAllocateIrpSignalEventInCompletionTimeout、IoBuildDeviceControlWait、IoBuildDeviceControlWaitTimeout、IoBuildFsdForward、IoBuildSynchronousFsdRequestWaitWait、IoBuildSynchronousFsdRequestWaitTimeout、IoSetCompletionRoutineCheckCheck、IrpProcessingComplete、LowerDriverReturn、MarkDevicePower、MarkingQueuedIrps、MarkIrpPending、MarkIrpPending2、 MarkPower(wdm)、 MarkPowerDown(wdm)、 MarkQueryRelations(wdm)、 MarkStartDevice(wdm)、PendedCompletedRequest2、PendedCompletedRequest3、PendedCompletedRequestEx、PnpIrpCompletion、PowerDownFail、PowerUpFail、RemoveLockForward、RemoveLockForward2、RemoveLockForwardDeviceControl、RemoveLockForwardDeviceControl2、RemoveLockForwardDeviceControlInternal、RemoveLockForwardDeviceControlInternal2、RemoveLockForwardRead、RemoveLockForwardRead2、RemoveLockForwardWrite、RemoveLockForwardWrite2、RemoveLockMnRemove2、RemoveLockMnSurpriseRemove、RemoveLockQueryMnRemove、TargetRelationNeedsRef、WmiForward