Edit

KSOBJECT_CREATE_ITEM structure (ks.h)

  • Article

The KSOBJECT_CREATE_ITEM structure is used to look up the string passed to a create request.

Syntax

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

Members

Create

Contains the create dispatch function for this particular base object class. See DRIVER_OBJECT for the signature of this function type.

Context

Points to a buffer that can be used to store object type-specific context information. Additional information is in the Remarks section below.

ObjectClass

Points to a Unicode string that identifies the object class. This is the string that was used to register with PnP for a particular class of object supported by this device.

SecurityDescriptor

Contains a pointer to a SECURITY_DESCRIPTOR for this type of object, otherwise NULL. If security is used, this must be freed when the object type is no longer used. This must use pool memory, and cannot be shared, as it may be replaced. If this is modified, the Flags element is updated. Optional.

Flags

Specifies the request type. Flags can have the values listed in the following table.

Flag Description
KSCREATE_ITEM_SECURITYCHANGED Indicates that the security descriptor on this object type has been changed and should be persisted.
KSCREATE_ITEM_WILDCARD Indicates that this create item represents a wild card that is used for any create requests that do not match any other create items. The ordering of the wild card entry in the list of create items is irrelevant. Only a single wild card entry is valid on any list of create items.
KSCREATE_ITEM_NOPARAMETERS Indicates that this create item does not allow any parameters to be passed, and fails if any are found. Normally, create parameters are passed on to the create handler. This cannot be used with a wild card flag.

Remarks

A pointer to the KSOBJECT_CREATE_ITEM structure is placed in the DriverContext member of Irp->Tail.Overlay before the object is created. You can access this pointer by using the KSCREATE_ITEM_IRP_STORAGE macro. This macro and related macros are included in ks.h.

The minidriver might retrieve this pointer when creating a new object to examine the Context field.

Requirements

Requirement Value
Header ks.h (include Ks.h)

See also

KsAllocateDeviceHeader

KsAllocateObjectHeader

KsFilterFactoryAddCreateItem