IAMTimecodeReader::GetTimecode-Methode (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Die GetTimecode -Methode ruft die neuesten Timecode-, Userbit- und Flagwerte ab, die im Stream verfügbar sind.
Syntax
HRESULT GetTimecode(
[out] PTIMECODE_SAMPLE pTimecodeSample
);
Parameter
[out] pTimecodeSample
Zeiger auf eine TIMECODE_SAMPLE-Struktur .
Rückgabewert
Gibt einen HRESULT-Wert zurück, der von der Implementierung der Schnittstelle abhängt.
Hinweise
Verwenden Sie diese Methode, um den Timecode zu überwachen und Duplikate und Diskontinuitäten zu analysieren.
Der Timecode enthält nicht definierte Bits, die als Userbits bezeichnet werden. Anwendungen können diese Bits verwenden, um Synchronisierungsinformationen oder andere benutzerdefinierte Informationen zu speichern.
DV- und MPEG-Camcorderimplementierung
Der MSDV-Treiber unterstützt das Lesen von SMPTE-Timecode oder absoluten Spurnummern (ATN). Der MSTape-Treiber unterstützt das Lesen des relativen Zeitzählers (RTC). Gehen Sie wie folgt vor, um Zeitinformationen auf diesen Geräten zu lesen:Legen Sie den dwFlags-Member der TIMECODE_SAMPLE-Struktur auf einen der folgenden Werte fest.
| Dauerhaft | BESCHREIBUNG |
|---|---|
| ED_DEVCAP_TIMECODE_READ | Timecode (DV) |
| ED_DEVCAP_ATN_READ | Absolute Spurnummer (DV) |
| ED_DEVCAP_RTC_READ | Relativer Zeitindikator (MPEG-Band) |
Das Timecodeelement der TIMECODE_SAMPLE-Struktur ist eine TIMECODE-Struktur . Initialisieren Sie den dwFrames-Member dieser Struktur auf 0.
Alle anderen Strukturmember werden ignoriert.
Wenn die Methode zurückgibt, enthält das dwFrames-Element die Zeitinformationen im folgenden Format.
| Zeitinformationen | Format |
|---|---|
| Timecode | Stunden, Minuten, Sekunden und Frames als binärcodiertes Dezimalwert (BCD): 0xhhmmssff. |
| ATN | Spurnummer. |
| RTC | Stunden, Minuten, Sekunden und Frames als BCD-Wert: 0xhhmmssff. Das wichtigste Bit des Framesbytes ist ein Zeichenbit. Wenn die Frameanzahl nicht verfügbar ist, werden die restlichen Framebits auf 0x7F festgelegt. |
Außerdem empfängt das dwUser-Element das leere Flagbit vom Gerät, das einen der folgenden Werte aufweist.
| Wert | BESCHREIBUNG |
|---|---|
| 0x00 | Keine Diskontinuität. |
| 0x01 | Diskontinuität. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |
| Bibliothek | Strmiids.lib |