Aracılığıyla paylaş


Okuyucu Nesnesi

[Windows Media Format 11 SDK bu sayfayla ilişkilendirilmiş özellik eski bir özelliktir. Kaynak Okuyucu ve Havuz Yazıcısıtarafından değiştirildi. Kaynak Okuyucu ve Havuz Yazıcısı Windows 10 ve Windows 11 için iyileştirilmiştir. Microsoft, yeni kodun mümkün olduğunda Windows Media Format 11 SDKyerine Kaynak Okuyucu ve Havuz Yazıcı kullanmasını kesinlikle önerir. Microsoft, mümkünse yeni API'leri kullanmak için eski API'leri kullanan mevcut kodun yeniden yazılmasını önerir.]

Okuyucu nesnesi, medya dosyalarından veri örneklerini okur. Okuyucu nesnesi şu anda gelişmiş sistem biçimi (ASF) dosya yapısını ve MP3 dosyalarını kullanan dosyaları destekler. Okuyucu nesnesi tarafından teslim edilen veriler sıkıştırılmamıştır ve varsayılan olarak işleme için hazırdır, ancak örnekler istenirse sıkıştırılmadan teslim edilebilir. Örnekler okuyucu nesnesinden zaman uyumsuz olarak teslim edilir; bunları almak için bir geri çağırma işlevi ayarlamanız gerekir. ASF dosyalarının zaman uyumlu kayıttan yürütülmesi için zaman uyumlu okuyucu nesnesini kullanın. Ne okuyucu ne de zaman uyumlu okuyucu herhangi bir veri işlemez. Bir dosyadan alınan medyayı görüntülemek için kendi işleme yordamlarınızı sağlamanız gerekir.

Bir dosya, okuyucu nesnesi tarafından desteklenen bir codec bileşeniyle çözülebilen kodlanmış medya içerdiğinde, sıkıştırılmamış çıkışın biçimini denetleyebilirsiniz. Bir akışın sıkıştırılmış çıktı biçimini değiştirmek için, bu akış için varsayılan çıkış medyası özellikleri nesnesini almanız, bu akışta değişiklik yapmanız ve okuyucudaki akışa yeniden atamanız gerekir. Çıktı medyası özellikleri nesneleri okuyucu nesnesine bağımlıdır ve yalnızca IWMReader::GetOutputProps yöntemi kullanılarak oluşturulmalıdır.

Okuyucu nesnesi, bir işaretçiyi IWMReader arabirimine ayarlayan WMCreateReaderişlevi tarafından oluşturulur. Okuyucu nesnesinin diğer arabirimleri, QueryInterface yöntemi çağrılarak elde edilebilir.

Aşağıdaki arabirimler okuyucu nesnesi tarafından desteklenir.

Arayüz Açıklama
IReferenceClock Okuyucu tarafından kullanılan sistem saatine erişim sağlar.
IWMDRMReader Lisans almayı, DRMözelliklerinive istemci bireyselleştirmesini yönetir.
IWMDRMReader2 Hakları belirtmek için çıkış koruma düzeylerini (OPL) kullanan lisanslara erişim sağlar.
IWMHeaderInfo Meta veriler,işaretçileri ve betik verileri dahil olmak üzere üst bilgi bilgilerini ayarlar ve alır.
IWMHeaderInfo2 Dosyadaki içeriği kodlamak için kullanılan codec bileşenleri hakkındaki bilgileri alır. IWMHeaderInfotüm yöntemlerini devralır.
IWMHeaderInfo3 Büyük öznitelik boyutlarını, yinelenen öznitelik adlarını ve birden çok dil desteğini destekler. IWMHeaderInfo ve IWMHeaderInfo2tüm yöntemlerini devralır.
IWMPacketSize Okuyucuya yüklenen dosyadaki en büyük paketin boyutunu alır.
IWMPacketSize2 Okuyucuya yüklenen dosyadaki en küçük paketin boyutunu alır.
IWMProfile Okuyucuya yüklenen dosyanın profil bilgilerine erişim sağlar.
IWMProfile2 Varsa, profille ilişkili genel benzersiz tanımlayıcıyı (GUID) alır. IWMProfiletüm yöntemlerini devralır.
IWMProfile3 Profilde bant genişliği paylaşımını ve akış önceliklendirme bilgilerini destekler. IWMProfile ve IWMProfile2yöntemlerinin tümünü devralır.
IWMReader Açma, kapatma, başlatma, duraklatma, sürdürme, durdurma ve çıkış özelliklerini alma ve ayarlama gibi işlemler de dahil olmak üzere temel dosya okuma özellikleri sağlar.
IWMReaderAccelerator DirectX video hızlandırma ile iletişim kurar.
IWMReaderAdvanced Okuyucunun kullanıcı tarafından sağlanan saat, arabellek ayırma, dönüş istatistikleri ve akış seçimi bildirimleri gibi gelişmiş özelliklerini sağlar.
IWMReaderAdvanced2 Mevcut okuyucu nesnesi için ek bir gelişmiş yöntem aralığı sağlar. IWMReaderAdvanced tüm yöntemlerini devralır.
IWMReaderAdvanced3 Gelişmiş arama ve akış denetimi sağlar. IWMReaderAdvanced ve IWMReaderAdvanced2yöntemlerinin tümünü devralır.
IWMReaderAdvanced4 Birden çok dil desteği de dahil olmak üzere gelişmiş okuyucu seçenekleri sağlar. IWMReaderAdvanced, IWMReaderAdvanced2ve IWMReaderAdvanced3yöntemlerinin tümünü devralır.
IWMReaderNetworkConfig Ağ yapılandırma ayarlarını denetler.
IWMReaderNetworkConfig2 Gelişmiş ağ yapılandırma ayarlarına erişim sağlar. IWMReaderNetworkConfigtüm yöntemlerini devralır.
IWMReaderStreamClock Akış saatlerindeki zamanlayıcıları ayarlar ve iptal eder ve belirtilen akış saatinin geçerli değerini alır.
IWMReaderTimecode Okuyucuya yüklenen dosyadaki SMPTE zaman kodu aralıkları hakkında bilgi sağlar.
IWMReaderTypeNegotiation Bir akışın çıkış özelliklerinde yapılan değişikliklerin düzgün çalışıp çalışmadığını sınar.

 

Okuyucu nesnesinin ilerleme durumunu izlemek için uygulamada aşağıdaki geri çağırma arabirimleri uygulanabilir.

Arayüz Açıklama
IWMCredentialCallback Kullanıcıların kimlik bilgilerini alır ve uzak bir siteye erişim iznine sahip olup olmadığını denetler.
IWMReaderAllocatorEx IWMReaderCallbackAdvanced arabiriminin AllocateForOutput ve AllocateForStream yöntemlerine genişletilmiş alternatifler sağlar.
IWMReaderCallback IWMReaderBaşlangıç ve Open yöntemleri için geri çağırma yöntemleri sağlar.
IWMReaderCallbackAdvanced IWMReaderAdvanced arabiriminin yöntemleri için geri çağırma yöntemleri sağlar.
IWMStatusCallback Durum bilgilerinin konak uygulamaya iletilmesi gerektiğinde gereklidir.

 

Nesneleri

ASF Dosyalarını okuma

Zaman Uyumlu Okuyucu Nesnesi