Funzione KsRegisterFilterWithNoKSPins (ks.h)
La funzione KsRegisterFilterWithNoKSPins viene registrata con filtri DirectShow senza pin di streaming del kernel e, pertanto, non vengono trasmessi in modalità kernel.
Sintassi
KSDDKAPI NTSTATUS KsRegisterFilterWithNoKSPins(
[in] PDEVICE_OBJECT DeviceObject,
[in] const GUID *InterfaceClassGUID,
[in] ULONG PinCount,
[in] BOOL *PinDirection,
[in] KSPIN_MEDIUM *MediumList,
[in, optional] GUID *CategoryList
);
Parametri
[in] DeviceObject
Puntatore a una struttura di DEVICE_OBJECT corrispondente al dispositivo a cui registrare il filtro.
[in] InterfaceClassGUID
Puntatore al GUID che rappresenta la classe da registrare. Ad esempio, questo fa riferimento a KSCATEGORY_TVTUNER per un filtro TvTuner.
[in] PinCount
Conteggio del numero di pin nel filtro.
[in] PinDirection
Puntatore al primo elemento di una matrice di valori booleani che indica la direzione del segnaposto per ogni segnaposto nel filtro. I pin di output sono TRUE; i pin di input sono FALSE. Questa matrice deve essere PinCount in lunghezza.
[in] MediumList
Puntatore al primo elemento di una matrice di strutture KSPIN_MEDIUM che definiscono i supporti per ogni puntino nel filtro. Questa matrice deve essere PinCount in lunghezza.
[in, optional] CategoryList
Puntatore al primo elemento di una matrice di GUID che definisce le categorie per ogni segnaposto nel filtro. Se questo parametro è presente, deve essere PinCount in lunghezza.
Valore restituito
Restituisce l'esito positivo o negativo della creazione della chiave FilterData nel Registro di sistema.
Commenti
Usare KsRegisterFilterWithNoKSPins per registrare TvTuners, Crossbars e componenti simili. KsRegisterFilterWithNoKSPins crea una nuova chiave del Registro di sistema, FilterData, che contiene i supporti e, facoltativamente, le categorie per ogni pin nel filtro.
Questa funzione viene usata solo per registrare i filtri senza pin del kernel corrispondenti. In caso di esito positivo, KsRegisterFilterWithNoKSPins crea una chiave nel Registro di sistema che può essere quindi usata da DirectShow.
Se si scrive un minidriver BDA, è consigliabile usare KsFilterFactoryUpdateCacheData anziché questa routine. Vedere i dettagli nella pagina di riferimento per KsFilterFactoryUpdateCacheData.
Per altre informazioni, vedere Descrittori AVStream e Inizializzazione di un minidriver AVStream.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile nei sistemi operativi Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX. |
Piattaforma di destinazione | Universale |
Intestazione | ks.h (include Ks.h) |
Libreria | Ks.lib |
IRQL | PASSIVE_LEVEL |