BdaFilterFactoryUpdateCacheData 関数 (bdasup.h)

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

BdaFilterFactoryUpdateCacheData 関数は、フィルターのインスタンスのピンデータキャッシュを更新します。

構文

NTSTATUS BdaFilterFactoryUpdateCacheData(
  [in]           PKSFILTERFACTORY          pFilterFactory,
  [in, optional] const KSFILTER_DESCRIPTOR *pFilterDescriptor
);

パラメーター

[in] pFilterFactory

ピンデータキャッシュを更新する KSFILTERFACTORY を指します。

[in, optional] pFilterDescriptor

ピンデータキャッシュが更新される省略可能な KSFILTER_DESCRIPTOR を指します。 NULL の場合は、代わりに pFilterFactory の記述子が使用されます。このパラメーターを使用すると、動的なピンの作成、つまりフィルターの作成ディスパッチルーチンが完了した後に発生するピンの作成が有効になります。

戻り値

STATUS_SUCCESSまたは適切なエラーコードを返します。フィルター記述子で渡されたカテゴリに対応するデバイスインターフェイスが見つからない場合は、STATUS_INVALID_PARAMETERを返します。

注釈

BDA ミニドライバーは 、BdaFilterFactoryUpdateCacheData 関数を呼び出して、 pFilterDescriptor で指定されたすべてのピンのピンデータキャッシュを更新します。この呼び出しでは、BDA ミニドライバーは通常、BDA フィルターのテンプレートトポロジを記述するBDA_FILTER_TEMPLATE構造体の pFilterDescriptor メンバーを pFilterDescriptor に渡します。 pFilterDescriptor が NULL の場合、pFilterFactory の KSFILTER_DESCRIPTOR メンバーで指定されたすべてのピンファクトリについて、キャッシュされた情報が更新されます。ピンデータキャッシュの詳細については、「 DirectShow のピン情報のキャッシュ」を参照してください。

KsRegisterFilterWithNoKSPins 関数は同様の機能を提供しますが、登録済みピンごとに 1 つのメディアのみを許可します。これは、BDA ミニドライバーでは十分でない場合があります。