Felületek alkalmazásokhoz
Ez a szakasz a Windows Media Device Manager SDK-t használó alkalmazások által az eszközökkel való kommunikációhoz használt vagy implementált felületeket ismerteti. Az itt használt "alkalmazás" minden olyan végrehajtható, beépülő modult vagy COM-objektumot jelent, amely asztali számítógépen található, és magas szintű kommunikációt igényel egy csatlakoztatott hordozható eszközzel. Ilyen lehet egy médialejátszó alkalmazás, egy Windows Media Player beépülő modul (ha közvetlen hozzáférésre van szüksége egy hordozható eszközhöz), vagy egy lejátszásszámláló com-objektum.
Ezen felületek némelyikét az alkalmazás implementálja, míg másokat az alkalmazás hív meg. Az egyes felületek dokumentációja jelzi, hogy implementálták vagy meghívták-e (és ha implementálták, akkor nem kötelező vagy kötelező).
Az alkalmazások az alábbi felületeket vagy osztályokat használják.
| Interfész vagy osztály | Leírás |
|---|---|
| CSecureChannelClient osztály | Egy segédosztály, amely lehetővé teszi az alkalmazások számára, hogy hitelesítsék magukat, titkosítják és visszafejtsék az adatokat, és macsokat hozzanak létre. |
| IWMDeviceManager | Az alkalmazások legfelső szintű Windows Media Device Manager felülete. |
| IWMDeviceManager2 | Kiterjeszti IWMDeviceManager speciális enumerálási módszerek és egyéb módszerek biztosításával. |
| IWMDeviceManager3 | Kibővíti a IWMDeviceManager2 felületet egy olyan metódus megadásával, amely beállítja az eszköz enumerálási beállításait. |
| IWMDMDevice | Módszereket biztosít egyetlen hordozható eszköz vizsgálatához és felfedezéséhez. |
| IWMDMDevice2 | Kibővíti IWMDMDevice azáltal, hogy lehetővé teszi az eszköz által támogatott videoformátumok lekérését, a név szerinti tárolást és a tulajdonságlapok használatát. |
| IWMDMDevice3 | Kibővíti IWMDMDevice2 azáltal, hogy metódusokat biztosít az eszköz tulajdonságainak lekérdezéséhez, az eszköz I/O-vezérlőkódjainak küldéséhez, valamint frissített módszereket biztosít a tárolók kereséséhez és az eszközformátum képességeinek lekéréséhez. |
| IWMDMDeviceControl | Metódusokat biztosít az eszközök vezérléséhez. |
| IWMDMDeviceSession | Javítja az eszközműveletek hatékonyságát, ha több műveletet egy munkamenetbe köt össze |
| IWMDMEnumDevice | Számbavétele a számítógéphez csatlakoztatott hordozható eszközök számbavétele. |
| IWMDMEnumStorage | Az eszközön lévő tárolók számbavétele. |
| IWMDMMetaData | Beállítja és lekéri a tár metaadat-tulajdonságait (például előadó, album, műfaj stb.). |
| IWMDMObjectInfo | Az IWMDMDeviceControl felületéről lekéri és beállítja az eszköz lejátszható fájljainak kezelését szabályozó információkat |
| IWMDMRevoked | Lekéri azt az URL-címet, amelyről a frissített összetevők letölthetők, ha az átvitel visszavonási hibával meghiúsul. |
| IWMDMStorage | Metódusokat biztosít egy eszköz tárhelyének (fájl, mappa, lejátszási lista) vizsgálatához és vizsgálatához. |
| IWMDMStorage2 | Kibővíti IWMDMStorage azáltal, hogy lehetővé teszi a gyermektároló név szerinti lekérését, valamint a kiterjesztett attribútumok lekérését és beállítását. |
| IWMDMStorage3 | Kiterjeszti IWMDMStorage2 metaadatok felfedésével. |
| IWMDMStorage4 | Kibővíti IWMDMStorage3 azáltal, hogy metódusokat biztosít a tárhoz elérhető metaadatok egy részhalmazának lekéréséhez, valamint a más tárolókra mutató hivatkozások listájának beállításához és lekéréséhez. |
| IWMDMStorageControl | Fájlok beszúrására, törlésére vagy áthelyezésére szolgál egy eszközön belül, illetve egy eszköz és a számítógép között. |
| IWMDMStorageControl2 | Kibővíti IWMDMStorageControl azáltal, hogy lehetővé teszi a célfájl nevének beállítását, amikor tartalmat szúr be egy tárolóba. |
| IWMDMStorageControl3 | Kibővíti IWMDMStorageControl2 úgy, hogy lehetővé teszi egy IWMDMMetaData felületmutató átadását. |
| IWMDMStorageGlobals | Metódusokat biztosít egy eszköz tárolóeszközével (például flash ROM-kártyájával) kapcsolatos globális információk lekéréséhez. |
| IWMDRMDeviceApp | Lehetővé teszi az alkalmazások számára az eszköz DRM-összetevőinek mérését, licencszinkronizálását és frissítését. |
| IWMDRMDeviceApp2 | Kibővíti IWMDRMDeviceApp a QueryDeviceStatus metódus új verziójának megadásával. |
Visszahívási felületek
Az alkalmazások az alábbi opcionális interfészeket implementálják az aszinkron kérések, például olvasási vagy írási kérések előrehaladásának nyomon követéséhez.
| Interfész | Leírás |
|---|---|
| IWMDMNotification | Lehetővé teszi, hogy az alkalmazások és a szolgáltatók értesítést kapjanak, ha az eszközök vagy a memóriatárolók (például a RAM-kártyák) csatlakoztatva vannak vagy le vannak választva a számítógépről. |
| IWMDMOperation2 | Kibővíti IWMDMOperation a kiterjesztett attribútumok lekérésére és beállítására szolgáló módszerek biztosításával. |
| IWMDMOperation3 | Kibővíti IWMDMOperation egy új módszerrel, amely titkosítatlan adatokat továbbít a hozzáadott hatékonyság érdekében. |
| IWMDMOperation | Lehetővé teszi az alkalmazások számára, hogy szabályozni tudja az adatok beolvasását vagy a számítógépre való írását a fájlátvitel során. |
| IWMDMProgress2 | Kiterjeszti a IWMDMProgress::End metódust egy állapotjelző megadásával. |
| IWMDMProgress3 | Kibővíti IWMDMProgress2 az eseményazonosító és a környezetspecifikus információk megadásához szükséges további bemeneti paraméterek megadásával. |
| IWMDMProgress | Lehetővé teszi az alkalmazások számára a műveletek előrehaladásának nyomon követését, például az adathordozók vagy a fájlátvitelek formázását. |
Az alábbi ábra bemutatja, hogyan szerezik be a legfontosabb alkalmazásfelületek többségét az IWMDeviceManager felület gyökér. Az alkalmazás ezt a gyökérfelületet a MediaDevMgr objektum társszerzőségével, az IComponentAuthenticate interfész kérésével, az összetevő hitelesítésével, majd a IWMDeviceManager kérésével kapja meg (ezeket a lépéseket az alkalmazás hitelesítéseismerteti). A gyökérillesztő beszerzése után IWMDeviceManager::EnumDevices meghívásával létrehoz egy objektumot, amely implementálja IWMDMEnumDevice. Az egyéb illesztők a megjelenített sorrendben a felületeken lévő metódusok meghívásával érhetők el. Az olyan származtatott interfészek, mint például IWMDMDevice2, QueryInterface meghívásával érhetők el az alapfelületen.
Az alábbi ábrán a származtatott illesztőket perjelek címkézik, így az "IWMDMStorage/2/3" azt jelzi, hogy IWMDMStorage, IWMDMStorage2és IWMDMStorage3.
Kapcsolódó témakörök