Функция KsRegisterFilterWithNoKSPins (ks.h)

Функция KsRegisterFilterWithNoKSPins регистрируется в фильтрах DirectShow, не имеющих пин-кодов потоковой передачи ядра, поэтому не выполняйте потоковую передачу в режиме ядра.

Синтаксис

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
);

Параметры

[in] DeviceObject

Указатель на DEVICE_OBJECT структуру, соответствующую устройству, к которому необходимо зарегистрировать фильтр.

[in] InterfaceClassGUID

Указатель на GUID, представляющий класс для регистрации. Например, это указывает на KSCATEGORY_TVTUNER фильтра TvTuner.

[in] PinCount

Количество закреплений в фильтре.

[in] PinDirection

Указатель на первый элемент массив логических значений, указывающий направление закрепления для каждого закрепления фильтра. Выходные закрепления TRUE; входные пин-коды FALSE. Этот массив должен быть pinCount длиной.

[in] MediumList

Указатель на первый элемент массива KSPIN_MEDIUM структур, определяющих среды для каждого закрепления фильтра. Этот массив должен быть pinCount длиной.

[in, optional] CategoryList

Указатель на первый элемент массива идентификаторов GUID, определяющий категории для каждого закрепления фильтра. Если этот параметр присутствует, он должен быть pinCount длиной.

Возвращаемое значение

Возвращает успех или сбой при создании раздела FilterData в реестре.

Замечания

Используйте KsRegisterFilterWithNoKSPins для регистрации TvTuners, кроссбаров и аналогичных компонентов. KsRegisterFilterWithNoKSPins создает новый раздел реестра, FilterData, содержащий носители, а также категории для каждого закрепления фильтра.

Эта функция используется только для регистрации фильтров, не имеющих соответствующих закреплений ядра. В случае успешного выполнения KsRegisterFilterWithNoKSPins создает раздел в реестре, который затем можно использовать DirectShow.

При написании мини-driver BDA рекомендуется использовать KsFilterFactoryUpdateCacheData вместо этой процедуры. Дополнительные сведения см. на справочной странице KsFilterFactoryUpdateCacheData.

Дополнительные сведения см. в дескрипторов AVStream и инициализации мини-AVStream Minidriver.

Требования

См. также

DEVICE_OBJECT

DRIVER_OBJECT

KsFilterFactoryUpdateCacheData

KsFilterRegisterPowerCallbacks