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

Функция KsAddObjectCreateItemToDeviceHeader добавляет указанный элемент создания в пустой элемент в ранее выделенном списке элементов создания для этого заголовка устройства. Пустой элемент обозначается 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.

Требования