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

こちらもご覧ください

KStrItemFreeCallback