共用方式為


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)

另請參閱

CONTROLLER_OBJECT

IoAllocateController

IoDeleteController

IoFreeController