Compartilhar via

Método IAMTimecodeReader::GetTimecode (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 GetTimecode método recupera os valores de código de tempo, userbit e sinalizador mais recentes disponíveis no fluxo.

Sintaxe

HRESULT GetTimecode(
  [out] PTIMECODE_SAMPLE pTimecodeSample
);

Parâmetros

[out] pTimecodeSample

Ponteiro para uma estrutura de TIMECODE_SAMPLE .

Retornar valor

Retorna um valor HRESULT que depende da implementação da interface.

Comentários

Use esse método para monitorar o código de tempo e analisar duplicatas e descontinuidades.

O código de tempo contém bits indefinidos, chamados userbits. Os aplicativos podem usar esses bits para armazenar informações de sincronização ou outras informações personalizadas.

Implementação de camcorder DV e MPEG

O driver MSDV dá suporte à leitura de código de tempo SMPTE ou ATN (números de faixa absolutos). O driver MSTape dá suporte à leitura do RTC (contador de tempo relativo). Para ler informações de tempo nesses dispositivos, faça o seguinte:

Defina o membro dwFlags da estrutura TIMECODE_SAMPLE como um dos valores a seguir.

Constante Descrição
ED_DEVCAP_TIMECODE_READ Código de tempo (DV)
ED_DEVCAP_ATN_READ Número de faixa absoluto (DV)
ED_DEVCAP_RTC_READ Contador de tempo relativo (fita MPEG)
 

O membro de código de tempo da estrutura TIMECODE_SAMPLE é uma estrutura TIMECODE . Inicialize o membro dwFrames dessa estrutura como zero.

Todos os outros membros da estrutura são ignorados.

Quando o método retorna, o membro dwFrames contém as informações de tempo, no formato a seguir.

Informações de tempo Formatar
Timecode Horas, minutos, segundos e quadros, como um valor decimal codificado binário (BCD): 0xhhmmssff.
ATN Rastrear número.
RTC Horas, minutos, segundos e quadros, como um valor BCD: 0xhhmmssff. O bit mais significativo do byte de quadros é um bit de sinal. Se a contagem de quadros não estiver disponível, os bits de quadro restantes serão definidos como 0x7F.
 

Além disso, o membro dwUser recebe o bit de sinalizador em branco do dispositivo, que tem um dos valores a seguir.

Valor Descrição
0x00 Não é uma descontinuidade.
0x01 Descontinuidade.

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

Confira também

Códigos de erro e êxito

Obtendo o timecode do dispositivo

IAMTimecodeReader Interface

  • Last updated on