Funzione BdaFilterFactoryUpdateCacheData (bdasup.h)

Articolo
02/06/2025

La funzione BdaFilterFactoryUpdateCacheData aggiorna la cache dei dati dei pin per un'istanza di un filtro.

Sintassi

NTSTATUS BdaFilterFactoryUpdateCacheData(
  [in]           PKSFILTERFACTORY          pFilterFactory,
  [in, optional] const KSFILTER_DESCRIPTOR *pFilterDescriptor
);

Parametri

[in] pFilterFactory

Punta al KSFILTERFACTORY per cui aggiornare la cache dei dati di aggiunta.

[in, optional] pFilterDescriptor

Punta a un KSFILTER_DESCRIPTOR facoltativo per cui verrà aggiornata la cache dei dati pin. Se null, viene invece utilizzato pFilterFactorydescrittore di . Questo parametro abilita la creazione dinamica del pin, ovvero la creazione di pin che si verifica dopo il completamento della routine dispatch di un filtro.

Valore restituito

Restituisce STATUS_SUCCESS o un codice di errore appropriato. Restituisce STATUS_INVALID_PARAMETER se non viene trovata alcuna interfaccia del dispositivo corrispondente alle categorie passate nel descrittore di filtro.

Osservazioni

Un minidriver BDA chiama la funzione di BdaFilterFactoryUpdateCacheData per aggiornare la cache dei dati dei pin per tutti i pin specificati in pFilterDescriptor. In questa chiamata, il minidriver BDA passa in genere il pFilterDescriptor membro di una struttura BDA_FILTER_TEMPLATE che descrive la topologia del modello per il filtro BDA per pFilterDescriptor. Se pFilterDescriptor è NULL , le informazioni memorizzate nella cache verranno aggiornate per tutte le pin factory specificate in membro KSFILTER_DESCRIPTORpFilterFactory. Per informazioni sulla cache dei dati di aggiunta, vedere Informazioni sul pin di memorizzazione nella cache per DirectShow.

La funzione KsRegisterFilterWithNoKSPins fornisce funzionalità simili, ma consente solo un supporto per pin registrato. Questo potrebbe non essere sufficiente per un minidriver BDA.