Função KsPinRegisterFrameReturnCallback (ks.h)
A funçãoKsPinRegisterFrameReturnCallback registra um retorno de chamada de retorno de quadro com AVStream para um determinado pin.
Sintaxe
void KsPinRegisterFrameReturnCallback(
[in] PKSPIN Pin,
[in] PFNKSPINFRAMERETURN FrameReturn
);
Parâmetros
[in] Pin
Um ponteiro para o AVStream estrutura de KSPIN que você deseja colocar no modo de injeção registrando um retorno de chamada de retorno de quadro.
[in] FrameReturn
Esse parâmetro fornece o endereço de um minidriver fornecido rotina de AVStrMiniFrameReturn.
Valor de retorno
Nenhum
Observações
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 insira 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.
Os 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 de retorno de quadro deve ser registrado antes da criação da seção de pipe do kernel. A seção pipe do kernel é criada quando o pino faz a transição para KSSTATE_ACQUIRE. Para obter mais informações, consulte de injeção de quadro.
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 | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |
| IRQL | PASSIVE_LEVEL |