IoDetachDevice function

The IoDetachDevice routine releases an attachment between the caller's device object and a lower driver's device object.

Syntax

NTKERNELAPI VOID IoDetachDevice(
  PDEVICE_OBJECT TargetDevice
);

Parameters

TargetDevice

Pointer to the lower driver's device object. The caller previously called IoAttachDevice or IoAttachDeviceToDeviceStack successfully to get this pointer.

Return Value

None

Remarks

IoDetachDevice decrements the reference count of the TargetDevice object. If the reference count goes to zero and the lower driver has been marked for an unload operation, the lower driver is unloaded.

Requirements

   
Windows version Available starting with Windows 2000.
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI compliance rules IrqlIoPassive3, PnpSurpriseRemove, PowerIrpDDis, RemoveLockCheck, HwStorPortProhibitedDDIs

See Also

IoAttachDevice

IoAttachDeviceToDeviceStack