Método IAMTimecodeReader::GetTimecode (strmif.h)
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
El GetTimecode método recupera los valores de código de tiempo, userbit y flag más recientes disponibles en la secuencia.
Sintaxis
HRESULT GetTimecode(
[out] PTIMECODE_SAMPLE pTimecodeSample
);
Parámetros
[out] pTimecodeSample
Puntero a una estructura de TIMECODE_SAMPLE .
Valor devuelto
Devuelve un valor HRESULT que depende de la implementación de la interfaz.
Comentarios
Use este método para supervisar el código de tiempo y analizar duplicados y discontinuidades.
El código de tiempo contiene bits no definidos, denominados userbits. Las aplicaciones pueden usar estos bits para almacenar información de sincronización u otra información personalizada.
Implementación de videocámara DV y MPEG
El controlador MSDV admite la lectura del código de tiempo SMPTE o números de seguimiento absolutos (ATN). El controlador MSTape admite la lectura del contador de tiempo relativo (RTC). Para leer información de tiempo en estos dispositivos, haga lo siguiente:Establezca el miembro dwFlags de la estructura TIMECODE_SAMPLE en uno de los valores siguientes.
| Constante | Descripción |
|---|---|
| ED_DEVCAP_TIMECODE_READ | Código de tiempo (DV) |
| ED_DEVCAP_ATN_READ | Número de pista absoluto (DV) |
| ED_DEVCAP_RTC_READ | Contador de tiempo relativo (cinta MPEG) |
El miembro timecode de la estructura TIMECODE_SAMPLE es una estructura TIMECODE . Inicialice el miembro dwFrames de esa estructura en cero.
Se omiten todos los demás miembros de la estructura.
Cuando el método devuelve, el miembro dwFrames contiene la información de hora, en el formato siguiente.
| Información de tiempo | Formato |
|---|---|
| Código | Horas, minutos, segundos y fotogramas, como un valor decimal codificado binario (BCD): 0xhhmmssff. |
| ATN | Número de seguimiento. |
| RTC | Horas, minutos, segundos y fotogramas, como un valor BCD: 0xhhhmmssff. El bit más significativo del byte de fotogramas es un bit de signo. Si el recuento de fotogramas no está disponible, los bits de fotograma restantes se establecen en 0x7F. |
Además, el miembro dwUser recibe el bit de marca en blanco del dispositivo, que tiene uno de los siguientes valores.
| Valor | Descripción |
|---|---|
| 0x00 | No es una discontinuidad. |
| 0x01 | Discontinuidad. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | strmif.h (incluya Dshow.h) |
| Library | Strmiids.lib |