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

Vedi anche

DEVICE_OBJECT

DRIVER_OBJECT

KsFilterFactoryUpdateCacheData

KsFilterRegisterPowerCallbacks