KsAllocateObjectBag 函式會建立物件包,並將它與 KSDEVICE產生關聯。
語法
KSDDKAPI NTSTATUS KsAllocateObjectBag(
[in] PKSDEVICE Device,
[out] KSOBJECT_BAG *ObjectBag
);
參數
[in] Device
KSDEVICE 指標,代表與新建立之物件包相關聯的裝置物件。
[out] ObjectBag
KSOBJECT_BAG的指標(KSOBJECT_BAG結構相當於 PVOID 類型),其中儲存了新配置的物件包。
傳回值
如果已建立新的物件包,則傳回STATUS_SUCCESS。 如果未配置新的物件包,則會傳回STATUS_INSUFFICIENT_RESOURCES。
言論
配置的物件包不會自動刪除。 呼叫 KsAllocateObjectBag 的迷你驅動程式負責刪除物件包。 若要這樣做,最簡單的方式是呼叫 KsFreeObjectBag。 或者,如果 minidriver 有包中項目的位址,minidriver 可以呼叫 KsRemoveItemFromObjectBag來個別刪除這些專案。
如需詳細資訊,請參閱 物件包。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。 |
目標平臺 | 普遍 |
標頭 | ks.h (包括 Ks.h) |
連結庫 | Ks.lib |
IRQL | PASSIVE_LEVEL |