Поделиться через


Функция обратного вызова PFNKSFILTERPROCESS (ks.h)

Подпрограмма AVStrMiniFilterProcess minidriver AVStream вызывается, когда фильтр предназначен для обработки кадров. Он используется для выполнения обработки, ориентированной на фильтрацию.

Синтаксис

PFNKSFILTERPROCESS Pfnksfilterprocess;

NTSTATUS Pfnksfilterprocess(
  [in] PKSFILTER Filter,
       PKSPROCESSPIN_INDEXENTRY Index
)
{...}

Параметры

[in] Filter

Указатель на структуру KSFILTER , которая должна обрабатывать кадры.

Index

Указатель на массив KSPROCESSPIN_INDEXENTRY структур, которые AVStream упорядочивает по идентификатору контакта.

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

Возврат STATUS_SUCCESS для продолжения обработки. Верните STATUS_PENDING, чтобы остановить обработку до следующего события активации. Мини-накопитель может возвращать код ошибки, но он будет обрабатываться так, как описано для STATUS_PENDING.

Комментарии

Мини-диск указывает адрес этой подпрограммы в элементе Process структуры KSFILTER_DISPATCH .

Подпрограмма вызывается в irQL = DISPATCH_LEVEL или PASSIVE_LEVEL в зависимости от предпочтений, выраженных в дескрипторове фильтра. Дескрипторы фильтров, указывающие KSFILTER_FLAG_DISPATCH_LEVEL_PROCESSING, могут иметь обратный вызов процесса в DISPATCH_LEVEL; Дескрипторы фильтров, не указывающие этот флаг, будут иметь обратный вызов процесса в PASSIVE_LEVEL.

Дополнительные сведения см. в разделах Фильтрация и Перезапуск обработки в AVStream.

Эта подпрограмма является необязательной.

Требования

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

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

KSFILTER_DISPATCH

KSPROCESSPIN_INDEXENTRY