Функция KsAllocateObjectBag (ks.h)
Функция KsAllocateObjectBa g создает контейнер объектов и связывает его с KSDEVICE.
Синтаксис
KSDDKAPI NTSTATUS KsAllocateObjectBag(
[in] PKSDEVICE Device,
[out] KSOBJECT_BAG *ObjectBag
);
Параметры
[in] Device
Указатель на KSDEVICE, представляющий объект устройства, связанный с вновь созданным контейнером объектов.
[out] ObjectBag
Указатель на KSOBJECT_BAG (структура KSOBJECT_BAG эквивалентна типу PVOID), где недавно выделенный контейнер объектов помещается.
Возвращаемое значение
Возвращает STATUS_SUCCESS, если создается новый контейнер объектов. Если новый контейнер объектов не выделен, он возвращает STATUS_INSUFFICIENT_RESOURCES.
Замечания
Выделенный контейнер объектов не удаляется автоматически. Мини-driver, вызывающий KsAllocateObjectBag отвечает за удаление контейнера объектов. Самый простой способ сделать это — вызвать KsFreeObjectBag. Кроме того, если мини-driver имеет адреса элементов в сумке, мини-driver может удалить их по отдельности, вызвав KsRemoveItemFromObjectBag.
Дополнительные сведения см. в пакетах объектов.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Microsoft Windows XP и более поздних операционных системах и версиях DirectX 8.0 и более поздних версий DirectX. |
| целевая платформа | Всеобщий |
| заголовка | ks.h (include Ks.h) |
| библиотеки | Ks.lib |
| IRQL | PASSIVE_LEVEL |