Fungsi KsAllocateObjectCreateItem (ks.h)
Fungsi KsAllocateObjectCreateItem mengalokasikan slot untuk item buat yang ditentukan, secara opsional mengalokasikan ruang untuk dan menyalin data buat item juga. Fungsi ini mengasumsikan bahwa pemanggil sedang menserialisasikan beberapa perubahan pada daftar entri buat.
Sintaks
KSDDKAPI NTSTATUS KsAllocateObjectCreateItem(
[in] KSDEVICE_HEADER Header,
[in] PKSOBJECT_CREATE_ITEM CreateItem,
[in] BOOLEAN AllocateEntry,
[in, optional] PFNKSITEMFREECALLBACK ItemFreeCallback
);
Parameter
[in] Header
Menunjuk ke header perangkat untuk melampirkan item buat.
[in] CreateItem
Berisi item buat yang akan dilampirkan.
[in] AllocateEntry
Menunjukkan apakah pointer buat item yang diteruskan harus dilampirkan langsung ke header , atau jika salinannya harus dibuat sebagai gantinya.
[in, optional] ItemFreeCallback
Secara opsional berisi penunjuk ke fungsi KStrItemFreeCallback yang ditentukan minidriver untuk dipanggil ketika entri buat sedang dihancurkan setelah membebaskan header perangkat. Ini hanya valid ketika AllocateEntry ADALAH TRUE.
Mengembalikan nilai
Mengembalikan STATUS_SUCCESS jika item baru dialokasikan dan dilampirkan. Jika tidak, ia mengembalikan STATUS_INSUFFICIENT_RESOURCES.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Header | ks.h (termasuk Ks.h) |
| Pustaka | Ks.lib |