Objektumok (Windows Media Format 11 SDK)
[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.]
A Windows Media Format SDK számos objektumot használ az ASF-fájlok olvasására, írására, szerkesztésére és indexelésére, valamint profilok létrehozására és szerkesztésére. Minden objektum számos interfészt támogat. Egyes felületek több objektumban is támogatottak. Ezekben az esetekben a felület referenciaszakaszában a megvalósításban tapasztalható eltéréseket tárgyaljuk.
A Windows Media Format SDK objektumai COM-kompatibilisek. A fejlesztés megkönnyítése érdekében minden objektumhoz tartozik egy létrehozási függvény vagy metódus. A COM-függvény CoCreateInstancehelyett a létrehozási függvénnyel vagy metódussal kell objektumokat létrehoznia.
Egyes felületeken egy szám van hozzáfűzve a nevükhöz, például IWMProfile2 és IWMWriter3. A számozott verziók minden esetben öröklik a korábbi verziók összes metódusát, és új funkciókat adnak hozzá.
A referencia minden egyes objektumoldalán a fő COM-objektumban található felületek jelennek meg először, majd az alkalmazás által implementálandó visszahívási felületek.
Az alábbi táblázat az SDK által támogatott objektumokat sorolja fel, amelyek ismertetik az egyes objektumok funkcióit és a létrehozásukhoz használt függvényt.
| Tárgy | Leírás | Létrehozási függvény |
|---|---|---|
| Backup Restorer | Biztonsági másolatot készít a licencekről, általában cserélhető adathordozóra, majd visszaállítja ezeket a licenceket egy másik számítógépre. | WMCreateBackupRestorer |
| eszközregisztrációs | Kezeli az eszközregisztrációs adatbázist, amely hálózati kapcsolaton keresztül elérhető médialejátszó eszközök bejegyzéseit tartalmazza. | WMCreateDeviceRegistration |
| DRM Transcryptor | A DRM által védett médiaadatokat adatfolyammá alakítja, amely a Windows Media DRM 10 for Network Devices protokollt használó eszközökre küldhető. | WMCreateDRMTranscryptor |
| Indexelő | Létrehoz egy indexet az ASF-fájlokhoz, amely lehetővé teszi a videostreameket tartalmazó fájlok keresését. | WMCreateIndexer |
| licencvisszavonási ügynök | Kezeli a licencek visszavonását. | WMCreateLicenseRevocationAgent |
| Metaadat-szerkesztő | Egy ASF-fájlfejléc metaadatainak szerkesztése. | WMCreateEditor |
| Profilkezelő | Felületeket biztosít profilok létrehozásához, betöltéséhez és mentéséhez. ASF-fájl írásához profil szükséges. | WMCreateProfileManager |
| Olvasó | ASF-fájlokat olvas. Ez az objektum aszinkron hívási modellt használ a műveleteihez. | WMCreateReader |
| Szinkron olvasó | AsF-fájlokat olvas szinkron hívások használatával. | WMCreateSyncReader |
| Író | ASF-fájlokat ír. | WMCreateWriter |
| írófájl-fogadó | Az íróobjektum által írt ASF-fájlokat szabályozza. | WMCreateWriterFileSink |
| íróhálózati fogadó | Az íróobjektum által írt ASF-fájlok élő hálózati streamelésének vezérlése. | WMCreateWriterNetworkSink |
| író leküldéses fogadó | Szabályozza a streamelési tartalmak közzétételi kiszolgálókra való továbbítását. | WMCreateWriterPushSink |
Az alábbi táblázat olyan objektumokat sorol fel, amelyek más objektumoktól függenek. Ezeket az objektumokat a meglévő objektumok metódusai hozzák létre.
| Tárgy | Leírás | Létrehozási módszer |
|---|---|---|
| sávszélesség-megosztási | Egy profil sávszélesség-megosztási információit kezeli. Egy profilhoz több sávszélesség-megosztó objektum is létezhet. A sávszélesség-megosztó objektum létrehozásának különböző módjai vannak attól függően, hogy új sávszélesség-megosztó objektumot szeretne létrehozni, vagy egy meglévőt szeretne elérni. |
IWMProfile3::CreateNewBandwidthSharingVAGY IWMProfile3::GetBandwidthSharing |
| puffer | Médiamintát és az adategység-bővítményeket tartalmazza. Írási és olvasási mintákhoz is használható. |
IWMWriter::AllocateSampleVAGY IWMReaderAllocatorEx::AllocateForOutputEx VAGY IWMReaderAllocatorEx::AllocateForStreamEx VAGY Az olvasóobjektum vagy a szinkron olvasóobjektum automatikusan létrehozza a mintaküldéshez. |
| bemeneti adathordozó tulajdonságai | Egy bemenet tulajdonságait kezeli. Minden bemenethez egy bemeneti tulajdonságobjektum létezhet. | IWMWriter::GetInputProps |
| kölcsönös kizárási | Kezeli a profilok kölcsönös kizárási adatait. A kölcsönös kizárás gyakori felhasználási módja a többbites sebességű tartalom és a hangsávok több nyelven. A kölcsönös kizárási objektum létrehozásának különböző módszerei vannak attól függően, hogy új kölcsönös kizárási objektumot szeretne létrehozni, vagy egy meglévőhöz szeretne hozzáférni. |
IWMProfile::CreateNewMutualExclusionVAGY IWMProfile::GetMutualExclusion |
| kimeneti adathordozó tulajdonságai | Kezeli a kimenet tulajdonságait. Minden kimenethez egy kimeneti médiatulajdonság-objektum létezhet. Ezeket az objektumokat az olvasó vagy a szinkron olvasó hozhatja létre |
IWMReader::GetOutputPropsVAGY IWMSyncReader::GetOutputProps |
| profil | A profilban lévő adatokat tartalmazza, miközben azokat manipulálják. A profilobjektumok bármikor létrejönnek, amikor a profilt módosítani kell. A profilobjektumok létrehozásának különböző módjai vannak attól függően, hogy új profilt szeretne-e létrehozni, vagy egy meglévőt szeretne elérni. |
IWMProfileManager::CreateEmptyProfileVAGY IWMProfileManager::LoadProfileByData VAGY IWMProfileManager::LoadProfileByID VAGY IWMProfileManager::LoadSystemProfile |
| streamkonfigurációs | A profilon belüli stream tulajdonságainak kezelése. A streamkonfigurációs objektumokat streamobjektumok hozzák létre, amikor hozzá kell férnie a stream adataihoz. A streamkonfigurációs objektumok létrehozásának különböző módjai vannak attól függően, hogy új streamet vagy hozzáférést szeretne-e létrehozni és meglévőt. |
IWMProfile::CreateNewStreamVAGY IWMProfile::GetStream VAGY IWMProfile::GetStreamByNumber |
| Stream rangsorolási | Egy profil streamprioritási listáját tartja karban. Ha a rendelkezésre álló sávszélesség korlátozott, a streameket a rendszer a prioritás növelése érdekében elveti. Egy profilban csak egy stream priorizálási objektum lehet. | IWMProfile3::CreateNewStreamPrioritization |