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) |