Funzione BdaFilterFactoryUpdateCacheData (bdasup.h)
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.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | bdasup.h (include Bdasup.h) |
Libreria | Bdasup.lib |
IRQL | PASSIVE_LEVEL |