KsCopyObjectBagItems 関数 (ks.h)

[アーティクル]
02/26/2024

KsCopyObjectBagItems 関数は、あるオブジェクトバッグから別のオブジェクトバッグにすべての項目をコピーします。

構文

KSDDKAPI NTSTATUS KsCopyObjectBagItems(
  [in] KSOBJECT_BAG ObjectBagDestination,
  [in] KSOBJECT_BAG ObjectBagSource
);

パラメーター

[in] ObjectBagDestination

項目をコピーするKSOBJECT_BAG (PVOID 型と同等)。

[in] ObjectBagSource

項目が ObjectBagDestination にコピーされるKSOBJECT_BAG。

戻り値

コピーが成功した場合は、STATUS_SUCCESSを返します。それ以外の場合は、エラーコードを返します。ほとんどの場合、コピー操作を完了するにはシステムリソースが不十分であることを示すSTATUS_INSUFFICIENT_RESOURCESです。 STATUS_INSUFFICIENT_RESOURCESが返された場合、項目の一部 (すべてではなく) が ObjectBagSource から ObjectBagDestination にコピーされている可能性があります。

注釈

両方のバッグのミューテックスを保持する必要があることに注意してください。対象のオブジェクトバッグがフィルターまたはピンに関連付けられている場合は、フィルター制御ミューテックスを取得します。オブジェクトバッグがフィルターファクトリまたはデバイスに属している場合は、デバイスミューテックスを取得します。詳細については、「AVStream のオブジェクトバッグとミューテックス」を参照してください。

要件

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