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 usato invece il descrittore di FilterFactory. Specificare se la factory del filtro usa pin dinamici e deve aggiornare le informazioni per i pin di cui non è stata ancora 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 che corrisponde alle categorie passate nel descrittore di filtro.
Commenti
Questa funzione aggiorna la chiave FilterData e la cache Medium per tutte le categorie specificate in FilterDescriptor. Se FilterDescriptor è NULL, la cache FilterData e Medium vengono aggiornate per tutte le categorie specificate nel membro KSFILTER_DESCRIPTORfilterFactory.
KsRegisterFilterWithNoKSPins offre funzionalità simili, ma non deve essere usata se due istanze di KSFILTER_DESCRIPTOR nello stesso KSDEVICE sono registrate nella stessa categoria e differiscono solo nel 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 barre incrociate di stile analogico. Usare 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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | ks.h (include Ks.h) |
| Libreria | Ks.lib |