共用方式為


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

選擇性地包含 minidriver 定義的指標,KStrItemFreeCallback 函式,以在釋放裝置標頭時終結建立專案時呼叫。 只有當allocateEntry true true時才有效。

傳回值

如果已配置並附加新專案,則傳回STATUS_SUCCESS。 否則,它會傳回STATUS_INSUFFICIENT_RESOURCES。

要求

要求 價值
目標平臺 普遍
標頭 ks.h (包括 Ks.h)
連結庫 Ks.lib

另請參閱

KStrItemFreeCallback