Fungsi KsAddObjectCreateItemToDeviceHeader (ks.h)

  • Artikel

Fungsi KsAddObjectCreateItemToDeviceHeader menambahkan item buat yang ditentukan ke item kosong dalam daftar item buat yang dialokasikan sebelumnya untuk header perangkat ini. Item kosong ditandatangani oleh fungsi pengiriman buat NULL dalam entri. Fungsi ini mengasumsikan bahwa pemanggil sedang menserialisasikan beberapa perubahan pada daftar buat item.

Sintaks

KSDDKAPI NTSTATUS KsAddObjectCreateItemToDeviceHeader(
  [in]           KSDEVICE_HEADER      Header,
  [in]           PDRIVER_DISPATCH     Create,
  [in]           PVOID                Context,
  [in]           PWSTR                ObjectClass,
  [in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor
);

Parameter

[in] Header

Menunjuk ke header perangkat yang berisi tabel buat anak yang dialokasikan sebelumnya.

[in] Create

Menentukan fungsi buat pengiriman.

[in] Context

Menentukan parameter konteks.

[in] ObjectClass

Menentukan penunjuk ke string karakter yang dihentikan NULL yang akan digunakan untuk perbandingan pada permintaan pembuatan. Penunjuk ini harus tetap valid saat objek perangkat aktif.

[in, optional] SecurityDescriptor

Menentukan deskriptor keamanan. Ini harus tetap valid saat objek perangkat aktif. Parameter ini bersifat opsional.

Nilai kembali

Fungsi KsAddObjectCreateItemToDeviceHeader mengembalikan STATUS_SUCCESS jika slot item buat kosong ditemukan dan item ditambahkan. Jika tidak berhasil, ia akan mengembalikan STATUS_ALLOTTED_SPACE_EXCEEDED.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header ks.h (termasuk Ks.h)
Pustaka Ks.lib