структура KSOBJECT_CREATE_ITEM (ks.h)
Структура 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.
Мини-диск может получить этот указатель при создании нового объекта для проверки поля Контекст .
Требования
| Требование | Значение |
|---|---|
| Заголовок | ks.h (включая Ks.h) |