IoCreateController 例程會配置記憶體,並使用驅動程式決定大小的控制器擴充功能來初始化控制器物件。
語法
PCONTROLLER_OBJECT IoCreateController(
[in] ULONG Size
);
參數
[in] Size
指定要配置給控制器擴充功能的位元元組數目。
傳回值
IoCreateController 傳回控制器物件的指標,如果無法為要求的裝置擴充功能配置記憶體,則傳回 NULL 指標。
言論
控制器物件通常代表具有單一驅動程式執行 I/O 要求的附加裝置的實體裝置控制器。 控制器擴充功能是從非分頁集區配置,而且保證可由任何驅動程式例程和任意線程內容存取。
控制器物件可用來同步處理 I/O 作業,以目標裝置,其中 I/O 要求可以同時傳入單一整合型驅動程式。 驅動程式也可以使用控制器物件,透過裝置通道同步處理作業。
如果 IoCreateController 傳回 NULL,驅動程式應該會讓裝置啟動失敗。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 2000 開始提供。 |
| 目標平臺 | 普遍 |
| 標頭 | ntddk.h (包括 Ntddk.h) |
| 連結庫 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDIs(storport)、IrqlIoPassive2(wdm)、PowerIrpDDis(wdm) |