Share via

Функция KsAddObjectCreateItemToDeviceHeader (ks.h)

  • Статья

Функция KsAddObjectCreateItemToDeviceHeader добавляет указанный элемент create-item в пустой элемент в ранее выделенном списке элементов для этого устройства. Пустой элемент обозначается функцией диспетчеризации создания NULL в записи. Эта функция предполагает, что вызывающий объект сериализует несколько изменений в списке элементов создания.

Синтаксис

KSDDKAPI NTSTATUS KsAddObjectCreateItemToDeviceHeader(
  [in]           KSDEVICE_HEADER      Header,
  [in]           PDRIVER_DISPATCH     Create,
  [in]           PVOID                Context,
  [in]           PWSTR                ObjectClass,
  [in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor
);

Параметры

[in] Header

Указывает на заголовок устройства, содержащий ранее выделенную дочернюю таблицу создания.

[in] Create

Указывает функцию создания диспетчеризации.

[in] Context

Задает параметр контекста.

[in] ObjectClass

Указывает указатель на символьную строку с завершением NULL, которая будет использоваться для сравнения в запросах на создание. Этот указатель должен оставаться действительным, пока объект устройства активен.

[in, optional] SecurityDescriptor

Указывает дескриптор безопасности. Этот параметр должен оставаться действительным, пока объект устройства активен. Этот параметр является необязательным.

Возвращаемое значение

Функция KsAddObjectCreateItemToDeviceHeader возвращает STATUS_SUCCESS, если был найден пустой слот создания элемента и элемент был добавлен. В случае неудачи он возвращает STATUS_ALLOTTED_SPACE_EXCEEDED.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть ks.h (включая Ks.h)
Библиотека Ks.lib