Функция обратного вызова 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 | (См. раздел "Примечания") |