Adategység-bővítmények konfigurálása

[A laphoz társított funkció, Windows Media Format 11 SDKegy régi funkció. A Forrás-olvasó és Fogadó íróváltotta fel. Forrásolvasó és Kimeneti író Windows 10-hez és Windows 11-hez optimalizálták. A Microsoft határozottan javasolja, hogy az új kód használja a Forrásolvasót és a Sink Writer-t a Windows Media Format 11 SDKhelyett, ha lehetséges. A Microsoft javasolja, hogy az örökölt API-kat használó meglévő kódot át kell írni az új API-k használatára, ha lehetséges.]

Az ASF-fájlokba írt minták a médiamintákon kívül további információkat is tartalmazhatnak. Ez az információ adategység-bővítmények használatával érhető el. További információ az adategység-bővítményekről: Adategység-bővítmények.

Az adategység-bővítmények használatához konfigurálnia kell a profilban lévő streamet az elfogadásukhoz. Egy adatfolyam adategység-bővítményének konfigurálásához hajtsa végre az alábbi lépéseket.

  1. Az IWMStreamConfig2felületére mutató mutatót az IWMStreamConfigQueryInterface metódusának meghívásával szerezhet be.
  2. Hívja meg IWMStreamConfig2::AddDataUnitExtension, hogy regisztráljon egy adategység-bővítményt a streamhez.

A streamhez jelenleg regisztrált összes adategység-bővítménytípust megvizsgálhatja IWMStreamConfig2::GetDataUnitExtensionCount meghívásával a regisztrált adategység-bővítménytípusok számának lekéréséhez. Ezután végighaladhat az összes típuson, mindegyiknél használva az IWMStreamConfig2::GetDataUnitExtension hívását.

Az adategység-bővítmények mérete akkor van hozzárendelve, ha egy streamhez van konfigurálva. Számos adategység-bővítményrendszer állandó méretű adatokat (általában struktúrát) használ. Az adategység-bővítményeket azonban úgy is konfigurálhatja, hogy változó méretűek legyenek, ha a méretet 0xFFFF értékre állítja. A kódoláskor hozzárendelt adategység-bővítmények mérete 1 bájt és 65534 bájt között lehet. A variálható méretű adategység-bővítményeket dinamikus adategység-bővítményeknek is nevezik.

A dinamikus adategység-bővítmények használatának előnye, hogy szükség szerint mellékadatokat csatolhat. Ha meghatározott méretű adategység-bővítményt határoz meg, a stream minden mintájának ilyen méretű bővítményadatokat kell tartalmaznia, még akkor is, ha egyes mintákhoz nincs adata. A dinamikus adategység-bővítményekkel kihagyhat adategység-bővítményeket néhány mintából, ami helyet takarít meg, és csökkenti a sávszélességre vonatkozó követelményeket. Ha azonban az adategység-bővítmények változó méretűek, az olvasóobjektum nem tudja ellenőrizni a fogadott bővítményadatokat statikus méreten. Ellenőriznie kell, hogy a kapott bővítményadatok érvényesek-e, és nem torzítják-e a bitstreamet.

Az egyes adategység-bővítményeket mintákon kell beállítani az INSSBuffer3::SetProperty metódus használatával. További információkért lásd a Adategység-kiterjesztések beállításarészt.

Streamek konfigurálása