Sdílet prostřednictvím

Rozhraní pro aplikace

  • Článek

Tato část popisuje rozhraní používaná nebo implementovaná aplikacemi pomocí sady WINDOWS Media Device Manager SDK ke komunikaci se zařízeními. Pojem "aplikace" zde znamená jakýkoli spustitelný soubor, modul plug-in nebo objekt MODELU COM, který existuje na stolním počítači a vyžaduje komunikaci vysoké úrovně s připojeným přenosným zařízením. To může zahrnovat aplikaci přehrávače médií, modul plug-in Windows Media Player (pokud potřebuje přímý přístup k přenosnému zařízení) nebo objekt modelu COM pro měření počtu přehrávání.

Některá z těchto rozhraní jsou implementována aplikací, zatímco jiné jsou volány aplikací. Dokumentace pro každé rozhraní označuje, zda je implementována nebo volána (a pokud je implementována, zda je volitelná nebo povinná).

Aplikace používají následující rozhraní nebo třídy.

Rozhraní nebo třída Popis
CSecureChannelClient – třída Pomocná třída, která umožňuje aplikacím ověřovat se, šifrovat a dešifrovat data a vytvářet řadiče domény MA.
IWMDeviceManager Rozhraní Windows Media Device Manageru nejvyšší úrovně pro aplikace.
IWMDeviceManager2 Rozšiřuje IWMDeviceManager poskytováním pokročilých metod výčtu a dalších metod.
IWMDeviceManager3 Rozšiřuje rozhraní IWMDeviceManager2 zadáním metody, která nastaví předvolbu výčtu zařízení.
IWMDMDevice Poskytuje metody pro zkoumání a prozkoumání jednoho přenosného zařízení.
IWMDMDevice2 Rozšiřuje IWMDMDevice tím, že umožňuje získat formáty videa podporované zařízením, najít úložiště podle názvu a používat stránky vlastností.
IWMDMDevice3 Rozšiřuje IWMDMDevice2 tím, že poskytuje metody dotazování zařízení na vlastnosti, odesílání kódů řízení vstupně-výstupních operací zařízení a také poskytuje upgradované metody pro vyhledávání úložišť a načítání funkcí formátu zařízení.
IWMDMDeviceControl Poskytuje metody pro řízení zařízení.
IWMDMDeviceSession Zlepšuje efektivitu operací zařízení tím, že se více operací rozdělí do jedné relace.
IWMDMEnumDevice Vytvoří výčet přenosných zařízení připojených k počítači.
IWMDMEnumStorage Vytvoří výčet úložišť na zařízení.
IWMDMMetaData Nastaví a načte vlastnosti metadat (například interpret, album, žánr atd.) úložiště.
IWMDMObjectInfo Získá a nastaví informace, které řídí, jak přehrátelné soubory na zařízení zpracovává IWMDMDeviceControl rozhraní
IWMDMRevolat Načte adresu URL, ze které se dají stáhnout aktualizované komponenty, pokud přenos selže s chybou odvolání.
IWMDMStorage Poskytuje metody pro zkoumání a prozkoumání úložiště (soubor, složka, seznam stop) na zařízení.
IWMDMStorage2 Rozšiřuje IWMDMStorage tím, že umožňuje získat podřízené úložiště podle názvu a získat a nastavit rozšířené atributy.
IWMDMStorage3 Rozšiřuje IWMDMStorage2 zveřejněním metadat.
IWMDMStorage4 Rozšiřuje IWMDMStorage3 tím, že poskytuje metody pro načtení podmnožina dostupných metadat pro úložiště a nastavení a načtení seznamu odkazů na jiná úložiště.
IWMDMStorageControl Slouží k vkládání, odstraňování nebo přesouvání souborů v zařízení nebo mezi zařízením a počítačem.
IWMDMStorageControl2 Rozšiřuje IWMDMStorageControl tím, že umožňuje nastavit název cílového souboru při vkládání obsahu do úložiště.
IWMDMStorageControl3 Rozšiřuje IWMDMStorageControl2, aby bylo možné předat ukazatel rozhraní IWMDMMetaData rozhraní.
IWMDMStorageGlobals Poskytuje metody pro načítání globálních informací o úložném médiu (například flash rom) na zařízení.
IWMDRMDeviceApp Umožňuje aplikaci provádět měření, synchronizaci licencí a aktualizaci komponent DRM zařízení.
IWMDRMDeviceApp2 Rozšiřuje IWMDRMDeviceApp tím, že poskytuje novou verzi metody QueryDeviceStatus.

 

Rozhraní zpětného volání

Aplikace implementuje následující volitelná rozhraní, aby mohla sledovat průběh asynchronního požadavku, například požadavek na čtení nebo zápis.

Rozhraní Popis
IWMDMNotification Umožňuje aplikacím a poskytovatelům služeb přijímat oznámení, když jsou zařízení nebo paměťová úložiště (například karty RAM) připojené nebo odpojené od počítače.
IWMDMOperation2 Rozšiřuje IWMDMOperation poskytováním metod pro získání a nastavení rozšířených atributů.
IWMDMOperation3 Rozšiřuje IWMDMOperation tím, že poskytuje novou metodu pro přenos dat nešifrovaných pro zvýšení efektivity.
IWMDMOperation Umožňuje aplikaci řídit, jak se data čtou nebo zapisuje do počítače během přenosu souborů.
IWMDMProgress2 Rozšiřuje metodu IWMDMProgress::End zadáním ukazatele stavu.
IWMDMProgress3 Rozšiřuje IWMDMProgress2 zadáním dalších vstupních parametrů pro zadání ID události a informací specifických pro kontext.
IWMDMProgress Umožňuje aplikaci sledovat průběh operací, jako je formátování médií nebo přenosů souborů.

 

Následující diagram ukazuje, jak se většina důležitých aplikačních rozhraní získává z kořenového rozhraní IWMDeviceManager rozhraní. Aplikace získá toto kořenové rozhraní tím, že vytvoří objekt MediaDevMgr, vyžádá IComponentAuthenticate rozhraní, ověřuje komponentu a potom požaduje IWMDeviceManager (tyto kroky jsou popsány v Ověřování aplikace). Po získání tohoto kořenového rozhraní IWMDeviceManager::EnumDevices je volána k vytvoření objektu, který implementuje IWMDMEnumDevice. Jiná rozhraní jsou získána voláním metod na rozhraních v uvedeném pořadí. Odvozená rozhraní, jako je IWMDMDevice2, se získávají voláním QueryInterface na základní rozhraní.

V následujícím diagramu jsou odvozená rozhraní označená lomítkem, takže "IWMDMStorage/2/3" označuje IWMDMStorage, IWMDMStorage2a IWMDMStorage3.

diagram znázorňující, jak získat hlavní aplikační rozhraní ve Správci zařízení windows Media

Referenčníprogramování