IoCreateController 関数 (ntddk.h)

IoCreateController ルーチンは、ドライバーによって決定されたサイズのコントローラー拡張を使用して、コントローラーオブジェクトのメモリを割り当て、初期化します。

構文

PCONTROLLER_OBJECT IoCreateController(
  [in] ULONG Size
);

[in] Size

コントローラー拡張機能に割り当てるバイト数を指定します。

IoCreateController は、要求されたデバイス拡張機能にメモリを割り当てられなかった場合は、コントローラーオブジェクトへのポインターまたは NULL ポインターを返します。

コントローラーオブジェクトは、通常、1 つのドライバーが I/O 要求を実行するデバイスが接続されている物理デバイスコントローラーを表します。コントローラー拡張機能は、非ページプールから割り当てられ、任意のスレッドコンテキストで任意のドライバールーチンからアクセス可能であることが保証されます。

コントローラーオブジェクトは、I/O 要求が 1 つのモノリシックドライバーに同時に送信できるデバイスを対象とする I/O 操作を同期するために使用されます。ドライバーでは、コントローラーオブジェクトを使用して、デバイスチャネルを介して操作を同期することもできます。

IoCreateController NULL 返された場合、ドライバーはデバイスの起動に失敗します。

要件	価値
サポートされる最小クライアント	Windows 2000 以降で使用できます。
ターゲットプラットフォームの	万国
ヘッダー	ntddk.h (Ntddk.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則をする	HwStorPortProhibitedDDDIs(storport), IrqlIoPassive2(wdm), PowerIrpDDis(wdm)