Método IAMExtDevice::Calibrate (strmif.h)
[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
O Calibrate método calibra o mecanismo de transporte de um dispositivo externo.
Este método não está implementado.
Sintaxe
HRESULT Calibrate(
[in] HEVENT hEvent,
[in] long Mode,
[out] long *pStatus
);
Parâmetros
[in] hEvent
Identificador de um evento. O evento é sinalizado quando a ação é concluída.
[in] Mode
Especifica um valor que ativa ou desativa o processo de calibragem:
| Valor | Descrição |
|---|---|
| ED_ACTIVE | Ativa o processo de calibragem. |
| ED_INACTIVE | Desativa o processo de calibragem. |
| NULL | Nenhuma ação; retornar o status de calibragem no pStatus. |
[out] pStatus
Ponteiro para um inteiro longo que recebe um dos seguintes valores:
| Valor | Descrição |
|---|---|
| OATRUE | A calibragem está ativa. |
| OAFALSE | A calibragem está inativa. |
Retornar valor
Quando esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .
Comentários
Use esse método em determinados dispositivos externos que exigem calibragem; por exemplo, retroceder uma fita e redefinir o contador ou calcular o deslocamento de quadro para um leitor de código de tempo.
Os filtros para vários dispositivos externos podem implementar esse método de forma diferente, dependendo da calibragem de que o dispositivo precisa. Esse método pressupõe que a interface IMediaEventSink já tenha estabelecido um coletor de eventos ou que outro método de sinalização de evento tenha sido estabelecido.
Implementação de DV
Os drivers MSDV e UVC não dão suporte a esse método. O método retorna E_NOTIMPL.Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |
| Biblioteca | Strmiids.lib |