IoFreeController function

The IoFreeController routine releases a previously allocated controller object when the driver has completed an I/O request.

Syntax

NTKERNELAPI VOID IoFreeController(
  PCONTROLLER_OBJECT ControllerObject
);

Parameters

ControllerObject

Pointer to the driver's controller object, which was allocated for the current I/O operation on a particular device by calling IoAllocateController.

Return Value

None

Remarks

The connection between the current target device object and the controller object is released only if no requests are currently queued to the same device. Otherwise, the driver's ControllerControl routine is called with the next IRP bound through the device controller to the target device.

Requirements

   
Windows version Available starting with Windows 2000.
Target Platform Universal
Header ntddk.h (include Ntddk.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL DISPATCH_LEVEL
DDI compliance rules IrqlDispatch, HwStorPortProhibitedDDIs, IrqlDispatch(storport)

See Also

IoAllocateController

IoCreateController

IoDeleteController