共用方式為


KsAllocateObjectBag 函式 (ks.h)

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

另請參閱

KsAddItemToObjectBag

KsCopyObjectBagItems

KsDiscard

KsFreeObjectBag

KsRemoveItemFromObjectBag