Функция обратного вызова PFNKSFILTERPROCESS (ks.h)
Подпрограмма AVStream minidriver AVStrMiniFilterProcess вызывается, когда фильтр предназначен для обработки кадров. Он используется для выполнения Filter-Centric обработки.
Синтаксис
PFNKSFILTERPROCESS Pfnksfilterprocess;
NTSTATUS Pfnksfilterprocess(
[in] PKSFILTER Filter,
PKSPROCESSPIN_INDEXENTRY Index
)
{...}
Параметры
[in] Filter
Указатель на структуру KSFILTER, которая должна обрабатывать кадры.
Index
Указатель на массив структур KSPROCESSPIN_INDEXENTRY, которые AVStream упорядочивает по идентификатору пин-кода.
Возвращаемое значение
Верните STATUS_SUCCESS для продолжения обработки. Верните STATUS_PENDING, чтобы остановить обработку до следующего события триггера. Мини-driver может возвращать код ошибки, но это будет рассматриваться как описано для STATUS_PENDING.
Замечания
Мини-driver задает адрес этой подпрограммы в элементе процесса его структуры KSFILTER_DISPATCH.
Подпрограмма вызывается в irQL = DISPATCH_LEVEL или PASSIVE_LEVEL в зависимости от предпочтения, выраженного в дескрипторе фильтра. Дескрипторы фильтров, которые указывают KSFILTER_FLAG_DISPATCH_LEVEL_PROCESSING, могут иметь обратный вызов процесса по DISPATCH_LEVEL; Дескрипторы фильтров, которые не указывают этот флаг, будут иметь обратный вызов процесса в PASSIVE_LEVEL.
Дополнительные сведения см. в разделе Filter-Centric Обработка и перезапуск в AVStream.
Эта подпрограмма является необязательной.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Microsoft Windows XP и более поздних операционных системах и версиях DirectX 8.0 и более поздних версий DirectX. |
| целевая платформа | Настольный |
| заголовка | ks.h (include Ks.h) |
| IRQL | (См. раздел "Примечания") |