Функция 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
При необходимости содержит указатель на определяемую мини-driver функцию KStrItemFreeCallback, вызываемую при уничтожении записи создания при освобождении заголовка устройства. Это допустимо только в том случае, если AllocateEntryTRUE.
Возвращаемое значение
Возвращает STATUS_SUCCESS, если новый элемент был выделен и присоединен. В противном случае возвращается STATUS_INSUFFICIENT_RESOURCES.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | ks.h (include Ks.h) |
| библиотеки | Ks.lib |