Função KsPinRegisterFrameReturnCallback (ks.h)
A função KsPinRegisterFrameReturnCallback registra um retorno de chamada de quadro com AVStream para um determinado pin.
Sintaxe
void KsPinRegisterFrameReturnCallback(
[in] PKSPIN Pin,
[in] PFNKSPINFRAMERETURN FrameReturn
);
Parâmetros
[in] Pin
Um ponteiro para a estrutura KSPIN do AVStream que você deseja colocar no modo de injeção registrando um retorno de chamada de quadro.
[in] FrameReturn
Esse parâmetro fornece o endereço de uma rotina AVStrMiniFrameReturn fornecida pelo minidriver.
Retornar valor
Nenhum
Comentários
Se um pino tiver registrado um retorno de chamada de retorno de quadro antes da transição de KSSTATE_STOP para KSSTATE_ACQUIRE, o pino será colocado no modo de injeção. Isso indica que o pino não receberá buffers e os preencherá, mas injetará manualmente quadros de dados no circuito usando KsPinSubmitFrame ou KsPinSubmitFrameMdl. Quando o quadro de dados conclui sua viagem ao redor do circuito e retorna ao pino no qual foi enviado, o AVStream o recicla chamando AVStrMiniFrameReturn.
Minidrivers que chamam essa função são diretamente responsáveis por injetar quadros no circuito; eles não recebem buffers para preencher e não interagem diretamente com a fila, assim como a maioria dos minidrivers. Observe também que o retorno de chamada do quadro deve ser registrado antes da criação da seção de pipe do kernel. A seção de pipe do kernel é criada quando o pino faz a transição para KSSTATE_ACQUIRE. Para obter mais informações, consulte Injeção de quadro.
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 | Universal |
| Cabeçalho | ks.h (inclua Ks.h) |
| Biblioteca | Ks.lib |
| IRQL | PASSIVE_LEVEL |