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
指向識別物件類別的 Unicode 字串。 這是用來向 PnP 註冊此裝置所支援之特定物件類別的字串。
SecurityDescriptor
包含這個物件類型 之SECURITY_DESCRIPTOR 指標，否則為 NULL。 如果使用安全性，當不再使用物件類型時，必須釋放這個值。 這必須使用集區內存，而且無法共享，因為可能會加以取代。 如果已修改此專案， 則會更新 Flags 元素。 選擇性。
Flags
指定要求類型。 旗標可以有下表所列的值。
| 旗標 | 描述 |
|---|---|
| KSCREATE_ITEM_SECURITYCHANGED | 表示此物件類型上的安全性描述項已變更，而且應該保存。 |
| KSCREATE_ITEM_WILDCARD | 表示此建立專案代表通配符，用於不符合任何其他建立專案的任何建立要求。 建立項目清單中的通配符項目順序無關。 在任何建立專案清單上，只有單一通配符專案有效。 |
| KSCREATE_ITEM_NOPARAMETERS | 表示此建立項目不允許傳遞任何參數，如果找到任何參數，就會失敗。 一般而言，create 參數會傳遞至 create 處理程式。 這無法與通配符旗標搭配使用。 |
備註
KSOBJECT_CREATE_ITEM 結構的指標會放在 Irp-Tail.Overlay> 的 DriverContext 成員中，然後再建立 物件。 您可以使用 KSCREATE_ITEM_IRP_STORAGE 宏來存取此指標。 此宏和相關宏包含在 ks.h 中。
迷你驅動程式可能會在建立新物件以檢查 [內容 ] 字段時擷取此指標。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | ks.h (包含 Ks.h) |