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 |