Olvasóobjektum
[A laphoz társított funkció, Windows Media Format 11 SDKegy régi funkció. A Forrásolvasó és Fogadó írójafelülírta. Forrásolvasó és Fogadó író Windows 10-hez és Windows 11-hez lett optimalizálva. A Microsoft határozottan javasolja, hogy az új kód Forrásolvasó és Fogadó író használjon 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 olvasóobjektum adatmintákat olvas be médiafájlokból. Az olvasóobjektum jelenleg a speciális rendszerformátumú (ASF) fájlstruktúrát és MP3-fájlokat használó fájlokat támogatja. Az olvasóobjektum által szolgáltatott adatok tömörítetlenek, és alapértelmezés szerint készen állnak a renderelésre, bár a minták igény szerint tömörítés nélkül is kézbesíthetők. A minták aszinkron módon érkeznek az olvasóobjektumból; a fogadásukhoz be kell állítania egy visszahívási függvényt. Az ASF-fájlok szinkron lejátszásához használja a szinkron olvasóobjektumot. Sem az olvasó, sem a szinkron olvasó nem jelenít meg adatokat. A fájlból lekért média megjelenítéséhez saját megjelenítési rutinokat kell megadnia.
Ha egy fájl kódolt adathordozót tartalmaz, amelyet az olvasóobjektum által támogatott kodekkel lehet dekódolni, szabályozhatja a tömörítetlen kimenet formátumát. Ha módosítani szeretné egy stream tömörített kimenetének formátumát, le kell kérnie a stream alapértelmezett kimeneti médiatulajdonság-objektumát, módosítania kell azt, és újra kell hozzárendelnie az olvasóban lévő streamhez. A kimeneti médiatulajdonságok objektumai alárendeltek az olvasóobjektumnak, és csak az IWMReader::GetOutputProps metódussal hozhatók létre.
Az olvasóobjektumot a WMCreateReaderfüggvény hozza létre, amely egy IWMReader felületre állítja az egérmutatót. Az olvasóobjektum többi felülete a QueryInterface metódus meghívásával érhető el.
Az olvasóobjektum az alábbi felületeket támogatja.
| Interfész | Leírás |
|---|---|
| IReferenceClock | Hozzáférést biztosít az olvasó által használt rendszerórához. |
| IWMDRMReader | Kezeli a licencek beszerzését, a DRM tulajdonságait és az ügyfél-individualizálást. |
| IWMDRMReader2 | Hozzáférést biztosít a kimeneti védelmi szinteket (OPL) használó licencekhez a jogosultságok megadásához. |
| IWMHeaderInfo | Beállítja és lekéri a fejlécadatokat, beleértve a metaadatokat, jelölőketés szkriptadatokat. |
| IWMHeaderInfo2 | Beolvassa a fájl tartalmának kódolásához használt kodekekről szóló információkat. Az IWMHeaderInfo összes metódusát örökli. |
| IWMHeaderInfo3 | Nagy attribútumméreteket, ismétlődő attribútumneveket és több nyelvi támogatást támogat. Örökli az IWMHeaderInfo és IWMHeaderInfo2összes metódusát. |
| IWMPacketSize | Lekéri az olvasóba betöltött fájl legnagyobb csomagjának méretét. |
| IWMPacketSize2 | Lekéri az olvasóba betöltött fájl legkisebb csomagjának méretét. |
| IWMProfile | Hozzáférést biztosít az olvasóba betöltött fájl profiladataihoz. |
| IWMProfile2 | Lekéri a profilhoz társított globálisan egyedi azonosítót (GUID), ha van ilyen. Az IWMProfile összes metódusát örökli. |
| IWMProfile3 | Támogatja a sávszélesség megosztását és a stream rangsorolási adatait a profilban. Örökli az IWMProfile és IWMProfile2 összes metódusát. |
| IWMReader | Alapvető fájlolvasási képességeket biztosít, beleértve az olyan műveleteket, mint a megnyitás, a bezárás, az indítás, a szüneteltetés, a folytatás, a leállítás és a kimeneti tulajdonságok beolvasása és beállítása. |
| IWMReaderAccelerator | A DirectX videógyorsítással kommunikál. |
| IWMReaderAdvanced | Az olvasó speciális funkcióit biztosítja, például a felhasználó által megadott órát, a pufferfoglalást, a visszatérési statisztikákat és a streamválasztási értesítéseket. |
| IWMReaderAdvanced2 | Egy meglévő olvasóobjektumhoz további speciális módszereket biztosít. Az IWMReaderAdvanced összes metódusát örökli. |
| IWMReaderAdvanced3 | Fejlett keresési és streamelési vezérlést biztosít. Az IWMReaderAdvanced és IWMReaderAdvanced2 összes metódusát örökli. |
| IWMReaderAdvanced4 | Speciális olvasói lehetőségeket biztosít, beleértve a több nyelvi támogatást is. Örökli az IWMReaderAdvanced, IWMReaderAdvanced2és IWMReaderAdvanced3metódusait. |
| IWMReaderNetworkConfig | Szabályozza a hálózati konfigurációs beállításokat. |
| IWMReaderNetworkConfig2 | Hozzáférést biztosít a speciális hálózati konfigurációs beállításokhoz. Az IWMReaderNetworkConfig összes metódusát örökli. |
| IWMReaderStreamClock | Beállítja és megszakítja az időzítőket a streamórákon, és lekéri egy adott streamóra aktuális értékét. |
| IWMReaderTimecode | Információt nyújt az olvasóba betöltött fájl SMPTE időkódtartományairól. |
| IWMReaderTypeNegotiation | Ellenőrzi, hogy a stream kimeneti tulajdonságainak módosítása megfelelően működik-e. |
Az alábbi visszahívási felületek implementálhatók az alkalmazásban egy olvasóobjektum előrehaladásának nyomon követéséhez.
| Interfész | Leírás |
|---|---|
| IWMCredentialCallback | Beolvasja a felhasználók hitelesítő adatait, és ellenőrzi, hogy rendelkezik-e engedéllyel egy távoli webhely eléréséhez. |
| IWMReaderAllocatorEx | Az IWMReaderCallbackAdvanced felület AllocateForOutput és AllocateForStream metódus ainak bővített alternatíváit kínálja. |
| IWMReaderCallback | Visszahívási metódusokat biztosít a Indítási és IWMReaderopen metódusaihoz. |
| IWMReaderCallbackAdvanced | Visszahívási metódusokat biztosít az IWMReaderAdvanced interfész metódusaihoz. |
| IWMStatusCallback | Akkor szükséges, ha az állapotinformációkat közölni kell a gazdaalkalmazással. |
Kapcsolódó témakörök