共用方式為

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 時才有效。

傳回值

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

規格需求

需求 值
目標平台 Universal
標頭 ks.h (包含 Ks.h)
程式庫 Ks.lib

另請參閱

KStrItemFreeCallback