Fungsi KsAllocateObjectBag (ks.h)
Fungsi KsAllocateObjectBag membuat tas objek dan mengaitkannya dengan KSDEVICE.
Sintaks
KSDDKAPI NTSTATUS KsAllocateObjectBag(
[in] PKSDEVICE Device,
[out] KSOBJECT_BAG *ObjectBag
);
Parameter
[in] Device
Pointer ke KSDEVICE yang mewakili objek perangkat yang terkait dengan tas objek yang baru dibuat.
[out] ObjectBag
Pointer ke KSOBJECT_BAG (struktur KSOBJECT_BAG setara dengan jenis PVOID) tempat tas objek yang baru dialokasikan disimpan.
Nilai kembali
Mengembalikan STATUS_SUCCESS jika tas objek baru dibuat. Jika tas objek baru tidak dialokasikan, tas tersebut akan mengembalikan STATUS_INSUFFICIENT_RESOURCES.
Keterangan
Tas objek yang dialokasikan tidak dihapus secara otomatis. Minidriver yang memanggil KsAllocateObjectBag bertanggung jawab untuk menghapus tas objek. Cara termampu untuk melakukan ini adalah dengan memanggil KsFreeObjectBag. Atau, jika minidriver memiliki alamat item dalam tas, minidriver dapat menghapusnya satu per satu dengan memanggil KsRemoveItemFromObjectBag.
Untuk informasi selengkapnya, lihat Object Bags.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows XP dan sistem operasi yang lebih baru dan DirectX 8.0 dan versi DirectX yang lebih baru. |
| Target Platform | Universal |
| Header | ks.h (termasuk Ks.h) |
| Pustaka | Ks.lib |
| IRQL | PASSIVE_LEVEL |