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 um estrutura de KSPIN a ser processada. Use essa rotina para executar de ProcessamentoPin-Centric.
- O KSPIN de 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.
Valor de retorno
Retorne STATUS_SUCCESS para continuar o processamento. Retorne STATUS_PENDING para interromper o processamento até o próximo evento de gatilho.
Observações
sobre o AVStrMiniPinProcess
O minidriver especifica o endereço dessa rotina no Process membro de sua estrutura KSPIN_DISPATCH.
Indique que um filtro usa Pin-Centric processando 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 nenhum sinalizador no descritor, o comportamento padrão é que o AVStream chama AVStrMiniPinProcess quando novos dados chegam a uma fila vazia anteriormente. 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 superior. Para fazer isso, chame KsStreamPointerClone . Consulte ponteiros de fluxo de borda à 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 superior.
A expedição do processo é feita no IRQL = PASSIVE_LEVEL padrão ou possivelmente em DISPATCH_LEVEL se o minidriver tiver especificado KSPIN_FLAG_DISPATCH_LEVEL_PROCESSING no KSPIN_DESCRIPTOR_EXrelevante.
Essa rotina é opcional.
sobre a AVStrMiniPinConnect
O minidriver especifica o endereço dessa rotina no Connect membro de sua estrutura de KSPIN_DISPATCH.
Retorne STATUS_SUCCESS ou o erro retornado da tentativa de estabelecer uma intra-conexão. Não retorne STATUS_PENDING.
Essa rotina é opcional.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | ks.h (incluir Ks.h) |
| IRQL | (Consulte a seção Comentários) |
Consulte também
Filter-Centric de Processamento
Pin-Centric de Processamento