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