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

Статья
08/07/2023

Функция 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.

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

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

Требования

Требование	Значение
Минимальная версия клиента	Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версиях.
Целевая платформа	Универсальное
Верхняя часть	ks.h (включая Ks.h)
Библиотека	Ks.lib
IRQL	PASSIVE_LEVEL

См. также раздел

DEVICE_OBJECT

DRIVER_OBJECT

KsFilterFactoryUpdateCacheData

KsFilterRegisterPowerCallbacks

Share via