Функция 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.
При написании мини-драйвера BDA вместо этой процедуры рекомендуется использовать KsFilterFactoryUpdateCacheData . Дополнительные сведения см. на странице справочника по KsFilterFactoryUpdateCacheData.
Дополнительные сведения см. в разделах Дескрипторы AVStream и Инициализация avStream Minidriver.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версиях. |
Целевая платформа | Универсальное |
Верхняя часть | ks.h (включая Ks.h) |
Библиотека | Ks.lib |
IRQL | PASSIVE_LEVEL |