次の方法で共有


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 を呼び出すことです。 または、ミニドライバーがバッグ内の項目のアドレスを持っている場合、ミニドライバーは KsRemoveItemFromObjectBag を呼び出すことによって、それらを個別に削除できます。

詳細については、「 オブジェクト バッグ」を参照してください。

要件

要件
サポートされている最小のクライアント Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。
対象プラットフォーム ユニバーサル
Header ks.h (Ks.h を含む)
Library Ks.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

KsAddItemToObjectBag

KsCopyObjectBagItems

KsDiscard

KsFreeObjectBag

KsRemoveItemFromObjectBag