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 |