IoCreateController function

The IoCreateController routine allocates memory for and initializes a controller object with a controller extension of a driver-determined size.

Syntax

PCONTROLLER_OBJECT IoCreateController(
  ULONG Size
);

Parameters

Size

Specifies the number of bytes to be allocated for the controller extension.

Return Value

IoCreateController returns a pointer to the controller object or a NULL pointer if memory could not be allocated for the requested device extension.

Remarks

A controller object usually represents a physical device controller with attached devices on which a single driver carries out I/O requests. The controller extension is allocated from nonpaged pool and is guaranteed to be accessible by any driver routine and in an arbitrary thread context.

The controller object is used to synchronize I/O operations to target devices for which I/O requests can come in concurrently to a single, monolithic driver. A driver also might use a controller object to synchronize operations through device channels.

If IoCreateController returns NULL, the driver should fail device start-up.

Requirements

   
Minimum supported client Available starting with Windows 2000.
Target Platform Universal
Header ntddk.h (include Ntddk.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI compliance rules IrqlIoPassive2, PowerIrpDDis, HwStorPortProhibitedDDIs

See Also

CONTROLLER_OBJECT

IoAllocateController

IoDeleteController

IoFreeController