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