IoCreateController 函式 (ntddk.h)

IoCreateController 例程會為配置記憶體，並使用驅動程式決定大小的控制器擴充功能來初始化控制器物件。

語法

PCONTROLLER_OBJECT IoCreateController(
  [in] ULONG Size
);

[in] Size

指定要配置給控制器擴充功能的位元元組數目。

如果無法為要求的裝置擴充功能配置記憶體，IoCreateController 會傳回控制器物件的指標或 NULL 指標。

控制器物件通常代表實體裝置控制器，其中包含單一驅動程式執行 I/O 要求的附加裝置。控制器擴充功能是從非分頁集區配置，而且保證可由任何驅動程式例程和任意線程內容存取。

控制器物件用來將 I/O 作業同步處理至目標裝置，I/O 要求可以同時傳入單一整合型驅動程式。驅動程式也可以使用控制器物件，透過裝置通道同步處理作業。

如果 IoCreateController 傳回 NULL，驅動程式應該會讓裝置啟動失敗。

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	Universal
標頭	ntddk.h (包含 Ntddk.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 合規性規則	HwStorPortProhibitedDDIs (storport) 、 IrqlIoPassive2 (wdm) 、 PowerIrpDDis (wdm)