Funzione KsFilterFactoryUpdateCacheData (ks.h)
La funzione KsFilterFactoryUpdateCacheData aggiorna la chiave del Registro di sistema FilterData e la cache media (un set di chiavi del Registro di sistema) per una determinata factory di filtro.
Sintassi
KSDDKAPI NTSTATUS KsFilterFactoryUpdateCacheData(
[in] PKSFILTERFACTORY FilterFactory,
[in, optional] const KSFILTER_DESCRIPTOR *FilterDescriptor
);
Parametri
[in] FilterFactory
KSFILTERFACTORY per cui aggiornare FilterData e Media cache nel Registro di sistema.
[in, optional] FilterDescriptor
Un KSFILTER_DESCRIPTOR facoltativo per cui verrà aggiornata la chiave FilterData e la cache media. Se NULL, viene invece usato filterFactorydescrittore. Specificare se la factory del filtro usa pin dinamici e deve aggiornare le informazioni per i pin di cui non è ancora stata creata un'istanza.
Valore restituito
KsFilterFactoryUpdateCacheData restituisce STATUS_SUCCESS o un codice di errore che indica se le informazioni del Registro di sistema pertinenti sono state aggiornate correttamente. Restituisce STATUS_INVALID_PARAMETER se non viene trovata alcuna interfaccia del dispositivo corrispondente alle categorie passate nel descrittore di filtro.
Osservazioni
Questa funzione aggiorna la chiave FilterData e la cache media per tutte le categorie specificate in FilterDescriptor. Se filterDescriptor è NULL , la cache FilterData e Medium viene aggiornata per tutte le categorie specificate in membro KSFILTER_DESCRIPTOR FilterFactory.
KsRegisterFilterWithNoKSPins fornisce funzionalità simili, ma non deve essere usata se due istanze di KSFILTER_DESCRIPTOR nella stessa KSDEVICE vengono registrate nella stessa categoria e differiscono solo in GUID di riferimento. In questo caso, KsRegisterFilterWithNoKSPins aggiorna i dati solo per il primo, anche se il secondo potrebbe essere stato specificato.
Non usare questa routine al posto di KsRegisterFilterWithNoKSPins per i filtri senza pin KS, ad esempio le barre incrociate dello stile analogico. Utilizzare questa routine solo per un filtro specifico per il quale il minidriver passa la factory di filtro corrispondente.
Inoltre, KsRegisterFilterWithNoKSPins consente solo un supporto per pin registrato. Questo potrebbe non essere sufficiente per un minidriver BDA.
Per altre informazioni, vedere gerarchia di oggetti AVStream.
La funzione KsFilterFactoryUpdateCacheData può essere chiamata solo in PASSIVE_LEVEL.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | ks.h (include Ks.h) |
| libreria | Ks.lib |