Condividi tramite


Metodo IAMTimecodeReader::GetTimecode (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetTimecode metodo recupera i valori timecode, userbit e flag più recenti disponibili nel flusso.

Sintassi

HRESULT GetTimecode(
  [out] PTIMECODE_SAMPLE pTimecodeSample
);

Parametri

[out] pTimecodeSample

Puntatore a una struttura TIMECODE_SAMPLE .

Valore restituito

Restituisce un valore HRESULT che dipende dall'implementazione dell'interfaccia.

Commenti

Usare questo metodo per monitorare il timecode e analizzare duplicati e discontinuità.

Il timecode contiene bit non definiti, denominati userbit. Le applicazioni possono usare questi bit per archiviare le informazioni di sincronizzazione o altre informazioni personalizzate.

Implementazione dv e mpeg-

Il driver MSDV supporta la lettura del timecode SMPTE o dei numeri di traccia assoluti (ATN). Il driver MSTape supporta la lettura del contatore tempo relativo (RTC). Per leggere le informazioni sull'ora in questi dispositivi, eseguire le operazioni seguenti:

Impostare il membro dwFlags della struttura TIMECODE_SAMPLE su uno dei valori seguenti.

Costante Descrizione
ED_DEVCAP_TIMECODE_READ Timecode (DV)
ED_DEVCAP_ATN_READ Numero di traccia assoluto (DV)
ED_DEVCAP_RTC_READ Contatore tempo relativo (nastro MPEG)
 

Il membro timecode della struttura TIMECODE_SAMPLE è una struttura TIMECODE . Inizializzare il membro dwFrames della struttura su zero.

Tutti gli altri membri della struttura vengono ignorati.

Quando il metodo viene restituito, il membro dwFrames contiene le informazioni sull'ora, nel formato seguente.

Informazioni sull'ora Formato
Timecode Ore, minuti, secondi e fotogrammi come valore decimale codificato binario (BCD): 0xhhmmssff.
ATN Numero di traccia.
RTC Ore, minuti, secondi e frame, come valore BCD: 0xhhmmssff. Il bit più significativo del byte dei fotogrammi è un bit di segno. Se il numero di fotogrammi non è disponibile, i bit dei fotogrammi rimanenti vengono impostati su 0x7F.
 

Inoltre, il membro dwUser riceve il bit del flag vuoto dal dispositivo, che ha uno dei valori seguenti.

Valore Descrizione
0x00 Non una discontinuità.
0x01 Discontinuità.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Codici di errore e di esito positivo

Recupero di timecode dal dispositivo

Interfaccia IAMTimecodeReader