次の方法で共有

BdaFilterFactoryUpdateCacheData 関数 (bdasup.h)

  • [アーティクル]

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

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

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー bdasup.h (Bdasup.h を含む)
ライブラリ Bdasup.lib
IRQL PASSIVE_LEVEL

関連項目

BDA_FILTER_TEMPLATE

KSFILTERFACTORY

KSFILTER_DESCRIPTOR

KsRegisterFilterWithNoKSPins を する