Função de retorno de chamada PFNKSFILTERPROCESS (ks.h)

A rotina AVStrMiniFilterProcess de um minidriver AVStream é chamada quando o filtro é destinado a processar quadros. Ele é usado para executar o processamento centrado em filtro.

Sintaxe

PFNKSFILTERPROCESS Pfnksfilterprocess;

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

Parâmetros

[in] Filter

Ponteiro para a estrutura KSFILTER que deve processar quadros.

Index

Ponteiro para uma matriz de estruturas KSPROCESSPIN_INDEXENTRY que o AVStream ordena por ID de pino.

Retornar valor

Retorne STATUS_SUCCESS para continuar o processamento. Retorne STATUS_PENDING para interromper o processamento até o próximo evento de disparo. O minidriver pode retornar um código de erro, mas isso será tratado conforme descrito para STATUS_PENDING.

Comentários

O minidriver especifica o endereço dessa rotina no membro Process de sua estrutura de KSFILTER_DISPATCH .

A rotina é chamada em IRQL = DISPATCH_LEVEL ou PASSIVE_LEVEL dependendo da preferência expressa no descritor de filtro. Os descritores de filtro que especificam KSFILTER_FLAG_DISPATCH_LEVEL_PROCESSING podem ter seu retorno de chamada de processo em DISPATCH_LEVEL; os descritores de filtro que não especificam esse sinalizador terão o retorno de chamada do processo em PASSIVE_LEVEL.

Para obter mais informações, consulte Processamento centrado em filtro e Reiniciando o processamento no AVStream.

Essa rotina é opcional.

Requisitos

Confira também

KSFILTER_DISPATCH

KSPROCESSPIN_INDEXENTRY