Функция 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.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Верхняя часть | ks.h (включая Ks.h) |
| Библиотека | Ks.lib |