struktur KSOBJECT_CREATE_ITEM (ks.h)

Struktur KSOBJECT_CREATE_ITEM digunakan untuk mencari string yang diteruskan ke permintaan buat.

Sintaks

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

Anggota

Create

Berisi fungsi buat pengiriman untuk kelas objek dasar khusus ini. Lihat DRIVER_OBJECT untuk tanda tangan jenis fungsi ini.

Context

Menunjuk ke buffer yang dapat digunakan untuk menyimpan informasi konteks khusus jenis objek. Informasi tambahan ada di bagian Keterangan di bawah ini.

ObjectClass

Menunjuk ke string Unicode yang mengidentifikasi kelas objek. Ini adalah string yang digunakan untuk mendaftar dengan PnP untuk kelas objek tertentu yang didukung oleh perangkat ini.

SecurityDescriptor

Berisi penunjuk ke SECURITY_DESCRIPTOR untuk tipe objek ini, jika tidak , NULL. Jika keamanan digunakan, ini harus dikosongkan ketika jenis objek tidak lagi digunakan. Ini harus menggunakan memori kumpulan, dan tidak dapat dibagikan, karena mungkin diganti. Jika ini dimodifikasi, elemen Bendera diperbarui. Pilihan.

Flags

Menentukan jenis permintaan. Bendera bisa memiliki nilai yang tercantum dalam tabel berikut ini.

Bendera	Deskripsi
KSCREATE_ITEM_SECURITYCHANGED	Menunjukkan bahwa deskriptor keamanan pada tipe objek ini telah diubah dan harus dipertahankan.
KSCREATE_ITEM_WILDCARD	Menunjukkan bahwa item buat ini mewakili wild card yang digunakan untuk setiap permintaan pembuatan yang tidak cocok dengan item buat lainnya. Pengurutan entri wild card dalam daftar item buat tidak relevan. Hanya entri kartubebas tunggal yang valid pada daftar item buat apa pun.
KSCREATE_ITEM_NOPARAMETERS	Menunjukkan bahwa item buat ini tidak mengizinkan parameter apa pun diteruskan, dan gagal jika ada yang ditemukan. Biasanya, parameter buat diteruskan ke handler buat. Ini tidak dapat digunakan dengan bendera kartubebas.

Keterangan

Penunjuk ke struktur KSOBJECT_CREATE_ITEM ditempatkan di anggota DriverContextdari Irp-Tail.Overlay> sebelum objek dibuat. Anda dapat mengakses penunjuk ini dengan menggunakan makro KSCREATE_ITEM_IRP_STORAGE. Makro ini dan makro terkait disertakan dalam ks.h.

Minidriver mungkin mengambil penunjuk ini saat membuat objek baru untuk memeriksa bidang Konteks .

Persyaratan

Persyaratan	Nilai
Header	ks.h (termasuk Ks.h)

Lihat juga

KsAllocateDeviceHeader

KsAllocateObjectHeader

KsFilterFactoryAddCreateItem