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を返します。

必要条件

要件	価値
ターゲット プラットフォーム の	万国
ヘッダー	ks.h (Ks.h を含む)
ライブラリ	Ks.lib

関連項目

KStrItemFreeCallback