Funzione BdaFilterFactoryUpdateCacheData (bdasup.h)

Articolo
02/22/2024

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

Sintassi

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

Parametri

[in] pFilterFactory

Punta a KSFILTERFACTORY per cui aggiornare la cache dei dati pin.

[in, optional] pFilterDescriptor

Punta a un KSFILTER_DESCRIPTOR facoltativo per il quale verrà aggiornata la cache dei dati pin. Se NULL, viene invece usato il descrittore pFilterFactory. Questo parametro consente la creazione dinamica del pin, ovvero la creazione del pin che si verifica dopo il completamento della routine di invio 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.

Commenti

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

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