KsAddObjectCreateItemToDeviceHeader function (ks.h)
The KsAddObjectCreateItemToDeviceHeader function adds the specified create-item to an empty item in the previously allocated create item list for this device header. An empty item is signified by a NULL create dispatch function in the entry. This function assumes that the caller is serializing multiple changes to the create items list.
Syntax
KSDDKAPI NTSTATUS KsAddObjectCreateItemToDeviceHeader(
[in] KSDEVICE_HEADER Header,
[in] PDRIVER_DISPATCH Create,
[in] PVOID Context,
[in] PWSTR ObjectClass,
[in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor
);
Parameters
[in] Header
Points to the device header that contains the previously allocated child create table.
[in] Create
Specifies the create dispatch function.
[in] Context
Specifies the context parameter.
[in] ObjectClass
Specifies a pointer to a NULL-terminated character string that will be used for comparison on create requests. This pointer must remain valid while the device object is active.
[in, optional] SecurityDescriptor
Specifies the security descriptor. This must remain valid while the device object is active. This parameter is optional.
Return value
The KsAddObjectCreateItemToDeviceHeader function returns STATUS_SUCCESS if an empty create item slot was found and the item was added.If unsuccessful, it returns STATUS_ALLOTTED_SPACE_EXCEEDED.
Requirements
Requirement | Value |
---|---|
Target Platform | Universal |
Header | ks.h (include Ks.h) |
Library | Ks.lib |