структура KSOBJECT_CREATE_ITEM (ks.h)

Статья
02/29/2024

Структура KSOBJECT_CREATE_ITEM используется для поиска строки, переданной в запрос на создание.

Синтаксис

typedef struct {
  PDRIVER_DISPATCH     Create;
  PVOID                Context;
  UNICODE_STRING       ObjectClass;
  PSECURITY_DESCRIPTOR SecurityDescriptor;
  ULONG                Flags;
} KSOBJECT_CREATE_ITEM, *PKSOBJECT_CREATE_ITEM;

Члены

Create

Содержит функцию создания диспетчеризации для данного класса базового объекта. Сигнатуру этого типа функции см. в разделе DRIVER_OBJECT .

Context

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

ObjectClass

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

SecurityDescriptor

Содержит указатель на SECURITY_DESCRIPTOR для объекта этого типа, в противном случае — значение NULL. Если используется безопасность, она должна быть освобождена, если тип объекта больше не используется. Он должен использовать память пула и не может быть общим, так как его можно заменить. Если это изменение, элемент Flags обновляется. Необязательный элемент.

Flags

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

Flag	Описание
KSCREATE_ITEM_SECURITYCHANGED	Указывает, что дескриптор безопасности для этого типа объекта был изменен и должен быть сохранен.
KSCREATE_ITEM_WILDCARD	Указывает, что этот элемент создания представляет дикий карта, который используется для любых запросов на создание, которые не соответствуют другим элементам создания. Порядок записи wild карта в списке элементов создания не имеет значения. Только одна запись wild карта действительна в любом списке элементов создания.
KSCREATE_ITEM_NOPARAMETERS	Указывает, что этот элемент создания не разрешает передавать какие-либо параметры, и завершается ошибкой, если они найдены. Как правило, параметры создания передаются обработчику создания. Его нельзя использовать с диким флагом карта.

Указатель на структуру KSOBJECT_CREATE_ITEM помещается в элемент DriverContextобъекта Irp-Tail.Overlay> перед созданием объекта . Доступ к этому указателю можно получить с помощью макроса KSCREATE_ITEM_IRP_STORAGE. Этот макрос и связанные макросы включены в ks.h.

Мини-диск может получить этот указатель при создании нового объекта для проверки поля Контекст .