FOURCCMap-Klasse

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

fourccmap-Klassenhierarchie

Die FOURCCMap-Klasse ermöglicht die Konvertierung zwischen GUID-Medienuntertypen und FOURCC-32-Bit-Medientags im alten Stil. In den ursprünglichen Windows-Multimedia-APIs wurden Medientypen mit 32-Bit-Werten gekennzeichnet, die aus vier 8-Bit-Zeichen erstellt wurden und als FOURCCs bezeichnet wurden. DirectShow-Medientypen verfügen über GUIDs für den Untertyp, teilweise, weil diese einfacher zu erstellen sind (die Erstellung eines neuen FOURCC erfordert die Registrierung bei Microsoft). Da FOURCCs eindeutig sind, wurde eine 1:1-Zuordnung ermöglicht, indem ein Bereich von 4.000 Millionen GUIDs zugeordnet wurde, die FOURCCs darstellen. Dieser Bereich besteht aus allen GUIDsdes Formulars:

XXXXXXXX-0000-0010-8000-00AA00389B71

Diese Klasse vereinfacht die Konvertierung zwischen GUIDs und FOURCCs. Dies ist nur aus Gründen der Kompatibilität. Es wird empfohlen, alle neuen Medienuntertypen durch GUIDsdarzustellen, die von Guidgen.exe oder einem ähnlichen Tool erstellt wurden, und nicht durch das Zuordnen von FOURCCs.

Das Objekt wird von einer GUID ohne zusätzliche Datenmember abgeleitet und kann in eine GUID umgewandelt werden. Das Objekt kann zur Bauzeit ein FOURCC übergeben werden. Der Standardkonstruktor initialisiert fourcc auf null.

Die Methoden GetFOURCC und SetFOURCC überprüfen nicht, ob die festen Teile der GUID dem FOURCC-Bereich entsprechen. Wenn Sie also einen Zeiger auf eine GUID in einen Zeiger auf einen FOURCC umwandeln und dann das FOURCC-Feld festlegen oder abrufen, müssen Sie auch separat überprüfen, ob die GUID innerhalb des FOURCC-Bereichs liegt.

Elementfunktionen

Bezeichnung Wert
FOURCCMap Konstruktormethode.
GetFOURCC Ruft fourcc aus einem FOURCCMap-Objekt ab.
SetFOURCC Legt den FOURCC-Teil des FOURCCMap-Objekts fest.