Função de retorno de chamada PFNKSPIN (ks.h)
A rotina de retorno de chamada de um minidriver AVStream é chamada quando:
- Há dados disponíveis para uma estrutura KSPIN a ser processada. Use essa rotina para executar o processamento centrado em pin.
- O KSPIN relevante está servindo como um pino de coletor e está conectado a um pino de origem AVStream.
Sintaxe
PFNKSPIN Pfnkspin;
NTSTATUS Pfnkspin(
[in] PKSPIN Pin
)
{...}
Parâmetros
[in] Pin
Ponteiro para o KSPIN que tem dados de quadro disponíveis para processamento.
Retornar valor
Retorne STATUS_SUCCESS para continuar o processamento. Retorne STATUS_PENDING para interromper o processamento até o próximo evento de gatilho.
Comentários
Sobre AVStrMiniPinProcess
O minidriver especifica o endereço dessa rotina no membro Process de sua estrutura KSPIN_DISPATCH .
Indique que um filtro usa o Processamento Centrado em Pin fornecendo essa função de expedição. O minidriver define sinalizadores de fixação na estrutura de KSPIN_DESCRIPTOR_EX relevante que determina quando o AVStream chama AVStrMiniPinProcess. Se o minidriver não definir sinalizadores no descritor, o comportamento padrão é que o AVStream chame AVStrMiniPinProcess quando novos dados chegarem a uma fila anteriormente vazia. Consulte Pin-Centric Processamento para obter mais detalhes sobre gatilhos de processamento.
Após o processamento, o minidriver pode impedir que o quadro seja concluído clonando o ponteiro de fluxo de borda à esquerda. Para fazer isso, chame KsStreamPointerClone. Consulte Ponteiros de Stream à esquerda e à direita.
Como alternativa, especifique uma borda à direita distinta definindo KSPIN_FLAG_DISTINCT_TRAILING_EDGE em KSPIN_DESCRIPTOR_EX. Uma terceira opção é não avançar o ponteiro do fluxo de borda à esquerda.
A expedição do processo é feita no IRQL padrão = PASSIVE_LEVEL ou possivelmente em DISPATCH_LEVEL se o minidriver tiver especificado KSPIN_FLAG_DISPATCH_LEVEL_PROCESSING no KSPIN_DESCRIPTOR_EX relevante.
Essa rotina é opcional.
Sobre AVStrMiniPinConnect
O minidriver especifica o endereço dessa rotina no membro Connect de sua estrutura de KSPIN_DISPATCH .
Retornar STATUS_SUCCESS ou o erro retornado da tentativa de estabelecer uma intra-conexão. Não retorne STATUS_PENDING.
Essa rotina é opcional.
Consulte também KS Pins.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | ks.h (inclua Ks.h) |
| IRQL | (Consulte a seção Comentários) |