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:

[out] pStatus

Ponteiro para um inteiro longo que recebe um dos seguintes valores:

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

Requisitos

Confira também

Códigos de erro e êxito

IAMExtDevice Interface