KsAllocateObjectCreateItem 関数 (ks.h)
KsAllocateObjectCreateItem 関数は、指定した作成項目にスロットを割り当て、必要に応じて、アイテム作成データの領域を割り当ててコピーします。 この関数は、呼び出し元が複数の変更を作成エントリ リストにシリアル化していることを前提としています。
構文
KSDDKAPI NTSTATUS KsAllocateObjectCreateItem(
[in] KSDEVICE_HEADER Header,
[in] PKSOBJECT_CREATE_ITEM CreateItem,
[in] BOOLEAN AllocateEntry,
[in, optional] PFNKSITEMFREECALLBACK ItemFreeCallback
);
パラメーター
[in] Header
作成項目をアタッチするデバイス ヘッダーを指します。
[in] CreateItem
添付するアイテムの作成を格納します。
[in] AllocateEntry
渡されたアイテムの作成ポインターをヘッダーに直接アタッチするか、または代わりにコピーを作成する必要があるかどうかを示します。
[in, optional] ItemFreeCallback
必要に応じて、デバイス ヘッダーの解放時に作成エントリが破棄されるときに呼び出されるミニドライバー定義 の KStrItemFreeCallback 関数へのポインターを格納します。 これは、 AllocateEntry が TRUE の場合にのみ有効です。
戻り値
新しい項目が割り当てられ、アタッチされた場合にSTATUS_SUCCESSを返します。 それ以外の場合は、STATUS_INSUFFICIENT_RESOURCESを返します。
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
Header | ks.h (Ks.h を含む) |
Library | Ks.lib |