KsFilterFactoryUpdateCacheData 函式 （ks.h）
KsFilterFactoryUpdateCacheData 函式會更新指定篩選處理站的 FilterData 登錄機碼和 Medium 快取（一組登錄機碼）。
語法
KSDDKAPI NTSTATUS KsFilterFactoryUpdateCacheData(
[in] PKSFILTERFACTORY FilterFactory,
[in, optional] const KSFILTER_DESCRIPTOR *FilterDescriptor
);
參數
[in] FilterFactory
要更新登錄中 FilterData 和 Medium 快取的 KSFILTERFACTORY。
[in, optional] FilterDescriptor
將更新 FilterData 索引鍵和 Medium 快取的選擇性 KSFILTER_DESCRIPTOR。 如果 NULL，則會改用 filterFactory 的描述元。 如果篩選處理站使用動態釘選，且需要更新尚未具現化之針腳的資訊，請提供 。
傳回值
KsFilterFactoryUpdateCacheData 傳回STATUS_SUCCESS或失敗碼，指出是否已成功更新相關的登錄資訊。 如果找不到對應至篩選描述元中所傳遞類別的裝置介面，則會傳回STATUS_INVALID_PARAMETER。
言論
此函式會針對 filterDescriptor 中指定的所有類別更新 FilterData 索引鍵和中快取。 如果 FilterDescriptorNULL，則會更新 FilterData 和 Medium 快取，以 FilterFactory的 KSFILTER_DESCRIPTOR 成員指定的所有類別。
KsRegisterFilterWithNoKSPins 提供類似的功能，但如果相同 KSDEVICE 下的兩個 KSFILTER_DESCRIPTOR 實例在相同的類別中註冊，且只與參考 GUID 不同，則不應使用。 在此情況下，KsRegisterFilterWithNoKSPins 只更新第一個的數據，即使第二個可能已經指定。
請勿將此例程用於取代 KsRegisterFilterWithNoKSPins，以用於沒有 KS 針腳的篩選，例如模擬樣式橫條。 此例程僅適用於迷你驅動程式傳遞對應篩選處理站的特定篩選。
此外，KsRegisterFilterWithNoKSPins 只允許每個已註冊的針腳一個媒體。 這可能不足以用於 BDA 迷你驅動程式。
如需詳細資訊，請參閱 AVStream 物件階層。
KsFilterFactoryUpdateCacheData 函式只能在PASSIVE_LEVEL中呼叫。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 標頭 | ks.h （包括 Ks.h） |
| 連結庫 | Ks.lib |