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 |