BdaFilterFactoryUpdateCacheData 函式 (bdasup.h)

發行項
02/25/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 minidriver 會呼叫 BdaFilterFactoryUpdateCacheData 函式，以更新 pFilterDescriptor 指定之所有針腳的釘選數據快取。在此呼叫中，BDA minidriver 通常會將描述 BDA 篩選之範本拓撲的 pFilterDescriptorBDA_FILTER_TEMPLATE 成員傳遞至 pFilterDescriptor。如果 pFilterDescriptor 為 NULL，則會針對 pFilterFactory KSFILTER_DESCRIPTOR 成員指定的所有針腳處理站更新快取資訊。如需釘選數據快取的相關信息，請參閱快取 DirectShow 的快取釘選資訊。

KsRegisterFilterWithNoKSPins 函式提供類似的功能，但每個已註冊的針腳只允許一個媒體。這可能不足以用於 BDA 迷你驅動程式。