Objekt čtenáře
[Funkce přidružená k této stránce, Windows Media Format 11 SDK, je starší funkce. Byla nahrazena čtečkou zdroje a zapisovače jímky. a zapisovač jímky jsou optimalizované pro Windows 10 a Windows 11. Microsoft důrazně doporučuje, aby nový kód používal Čtečka zdrojového kódu a Zapisovač jímky místo Windows Media Format 11 SDK, pokud je to možné. Microsoft navrhuje, aby se stávající kód, který používá starší rozhraní API, přepsal, aby se nová rozhraní API používala, pokud je to možné.]
Objekt čtenáře čte ukázky dat z mediálních souborů. Objekt čtečky v současné době podporuje soubory používající strukturu souborů ve formátu ASF (Advanced Systems Format) i soubory MP3. Data doručovaná objektem čtenáře jsou ve výchozím nastavení nekomprimovaná a připravená k vykreslení, i když se vzorky dají doručit bez dekomprese, pokud je to žádoucí. Ukázky se doručují asynchronně z objektu čtenáře; Musíte nastavit funkci zpětného volání, která je bude přijímat. Pro synchronní přehrávání souborů ASF použijte synchronní objekt čtečky. Čtenář ani synchronní čtenář nevykreslí žádná data. Pokud chcete zobrazit multimédia načtená ze souboru, musíte zadat vlastní rutiny vykreslování.
Pokud soubor obsahuje kódované médium, které lze dekódovat pomocí kodeku podporovaného objektem čtečky, můžete řídit formát nekomprimovaného výstupu. Pokud chcete změnit formát dekomprimovaného výstupu pro datový proud, musíte pro tento stream načíst výchozí objekt vlastností výstupního média, provést změny a znovu ho přiřadit streamu v čtenáři. Objekty vlastností výstupních médií jsou podřízeny čtenář objektu a měly by být vytvořeny pouze pomocí IWMReader::GetOutputProps metoda.
Objekt čtečky je vytvořen funkcí WMCreateReader, který nastaví ukazatel na IWMReader rozhraní. Další rozhraní objektu čtenáře lze získat voláním QueryInterface metoda.
Objekt čtenáře podporuje následující rozhraní.
| Rozhraní | Popis |
|---|---|
| IReferenceClock | Poskytuje přístup k systémovým hodinům používaným čtečkou. |
| IWMDRMReader | Spravuje získávání licencí, DRM vlastnosti a individuální nastavení klienta. |
| IWMDRMReader2 | Poskytuje přístup k licencím, které k určení práv používají úrovně ochrany výstupu (OPL). |
| IWMHeaderInfo | Nastaví a načte informace hlavičky, včetně metadat, značeka dat skriptu. |
| IWMHeaderInfo2 | Načte informace o kodekech použitých k kódování obsahu v souboru. Dědí všechny metody IWMHeaderInfo. |
| IWMHeaderInfo3 | Podporuje velké velikosti atributů, duplicitní názvy atributů a podporu více jazyků. Dědí všechny metody IWMHeaderInfo a IWMHeaderInfo2. |
| IWMPacketSize | Načte velikost největšího paketu v souboru načteném v čtečce. |
| IWMPacketSize2 | Načte velikost nejmenšího paketu v souboru načteném v čtečce. |
| IWMProfile | Poskytuje přístup k informacím o profilu souboru načteného do čtečky. |
| IWMProfile2 | Načte globálně jedinečný identifikátor (GUID), pokud existuje, přidružený k profilu. Dědí všechny metody IWMProfile. |
| IWMProfile3 | Podporuje sdílení šířky pásma a informace o stanovení priorit datových proudů v profilu. Dědí všechny metody IWMProfile a IWMProfile2. |
| IWMReader | Poskytuje základní možnosti čtení souborů, včetně operací, jako jsou otevření, zavření, spuštění, pozastavení, obnovení, zastavení a získání a nastavení výstupních vlastností. |
| IWMReaderAccelerator | Komunikuje s akcelerací videa DirectX. |
| IWMReaderAdvanced | Poskytuje pokročilé funkce čtečky, jako jsou hodiny poskytované uživatelem, přidělení vyrovnávací paměti, návratové statistiky a oznámení o výběru streamu. |
| IWMReaderAdvanced2 | Poskytuje další rozsah pokročilých metod pro existující objekt čtenáře. Dědí všechny metody IWMReaderAdvanced. |
| IWMReaderAdvanced3 | Poskytuje pokročilé řízení hledání a streamování. Dědí všechny metody IWMReaderAdvanced a IWMReaderAdvanced2. |
| IWMReaderAdvanced4 | Poskytuje pokročilé možnosti čtečky, včetně podpory více jazyků. Dědí všechny metody IWMReaderAdvanced, IWMReaderAdvanced2a IWMReaderAdvanced3. |
| IWMReaderNetworkConfig | Řídí nastavení konfigurace sítě. |
| IWMReaderNetworkConfig2 | Poskytuje přístup k rozšířeným nastavením konfigurace sítě. Dědí všechny metody IWMReaderNetworkConfig. |
| IWMReaderStreamClock | Nastaví a zruší časovače u hodin streamu a načte aktuální hodnotu zadaných hodin datového proudu. |
| IWMReaderTimecode | Poskytuje informace o rozsahech časového kódu SMPTE v souboru načteném v čtečce. |
| IWMReaderTypeNegotiation | Testuje, zda změny výstupních vlastností datového proudu fungují správně. |
V aplikaci lze implementovat následující rozhraní zpětného volání, která sledují průběh objektu čtenáře.
| Rozhraní | Popis |
|---|---|
| IWMCredentialCallback | Získá přihlašovací údaje uživatelů a zkontroluje, že mají oprávnění pro přístup ke vzdálenému webu. |
| IWMReaderAllocatorEx | Poskytuje rozšířené alternativy k AllocateForOutput a AllocateForStream metody IWMReaderCallbackAdvanced rozhraní. |
| IWMReaderCallback | Poskytuje metody zpětného volání pro Start a Open metody IWMReader. |
| IWMReaderCallbackAdvanced | Poskytuje metody zpětného volání pro metody IWMReaderAdvanced rozhraní. |
| IWMStatusCallback | Vyžaduje se, když musí být informace o stavu předány hostitelské aplikaci. |
Související témata