Interfaces voor toepassingen
In deze sectie worden interfaces beschreven die door toepassingen worden gebruikt of geïmplementeerd met behulp van de Windows Media Device Manager SDK om te communiceren met apparaten. De term 'toepassing' die hier wordt gebruikt, betekent elk uitvoerbaar, plug-in of COM-object dat op een desktopcomputer aanwezig is en communicatie op hoog niveau met een verbonden draagbaar apparaat nodig heeft. Dit kan bestaan uit een mediaspelertoepassing, een Windows Media Player-invoegtoepassing (als deze directe toegang nodig heeft tot een draagbaar apparaat) of een COM-object voor het meten van play-count.
Sommige van deze interfaces worden geïmplementeerd door de toepassing, terwijl andere worden aangeroepen door de toepassing. De documentatie voor elke interface geeft aan of deze is geïmplementeerd of aangeroepen (en indien geïmplementeerd, of deze optioneel of vereist is).
De volgende interfaces of klassen worden gebruikt door toepassingen.
| Interface of klasse | Beschrijving |
|---|---|
| CSecureChannelClient-klasse | Een helperklasse waarmee toepassingen zichzelf kunnen verifiëren, gegevens kunnen versleutelen en ontsleutelen en MACs kunnen maken. |
| IWMDeviceManager | De Windows Media Device Manager-interface op het hoogste niveau voor toepassingen. |
| IWMDeviceManager2 | Breidt IWMDeviceManager uit door geavanceerde opsommingsmethoden en andere methoden te bieden. |
| IWMDeviceManager3 | Breidt de IWMDeviceManager2 interface uit door een methode op te geven waarmee de voorkeur voor de opsomming van het apparaat wordt ingesteld. |
| IWMDMDevice- | Biedt methoden voor het onderzoeken en verkennen van één draagbaar apparaat. |
| IWMDMDevice2- | Breidt IWMDMDevice- uit door de video-indelingen te verkrijgen die door een apparaat worden ondersteund, een opslag op naam te zoeken en eigenschappenpagina's te gebruiken. |
| IWMDMDevice3- | Breidt IWMDMDevice2- uit door methoden te bieden om een apparaat te doorzoeken op eigenschappen, I/O-controlecodes van apparaten te verzenden en ook bijgewerkte methoden te bieden om te zoeken naar opslag en mogelijkheden voor apparaatindeling op te halen. |
| IWMDMDeviceControl | Biedt methoden voor het beheren van apparaten. |
| IWMDMDeviceSession- | Verbetert de efficiëntie van apparaatbewerkingen door meerdere bewerkingen in één sessie te bundelen |
| IWMDMEnumDevice- | Bevat draagbare apparaten die zijn gekoppeld aan een computer. |
| IWMDMEnumStorage- | Inventariseert opslag op een apparaat. |
| IWMDMMetaData- | Hiermee worden metagegevenseigenschappen (zoals artiest, album, genre, enzovoort) van een opslag ingesteld en opgehaald. |
| IWMDMObjectInfo- | Hiermee wordt informatie opgehaald en ingesteld waarmee wordt bepaald hoe afspeelbare bestanden op het apparaat worden verwerkt door de IWMDMDeviceControl interface |
| IWMDMRevoked- | Haalt de URL op van waaruit bijgewerkte onderdelen kunnen worden gedownload, als een overdracht mislukt met een intrekkingsfout. |
| IWMDMStorage- | Biedt methoden voor het onderzoeken en verkennen van een opslag (bestand, map, afspeellijst) op een apparaat. |
| IWMDMStorage2- | Breidt IWMDMStorage uit door het mogelijk te maken om een onderliggende opslag op naam op te halen en uitgebreide kenmerken op te halen en in te stellen. |
| IWMDMStorage3- | Breidt IWMDMStorage2 uit door metagegevens weer tegeeft. |
| IWMDMStorage4- | Breidt IWMDMStorage3- uit door methoden op te geven voor het ophalen van een subset van beschikbare metagegevens voor een opslag en voor het instellen en ophalen van een lijst met verwijzingen naar andere opslag. |
| IWMDMStorageControl | Wordt gebruikt voor het invoegen, verwijderen of verplaatsen van bestanden binnen een apparaat of tussen een apparaat en de computer. |
| IWMDMStorageControl2 | Breidt IWMDMStorageControl uit door de naam van het doelbestand in te stellen bij het invoegen van inhoud in een opslag. |
| IWMDMStorageControl3- | Breidt IWMDMStorageControl2 uit door het mogelijk te maken om een IWMDMMetaData interfaceaanwijzer door te geven. |
| IWMDMStorageGlobals- | Biedt methoden voor het ophalen van algemene informatie over een opslagmedium (zoals een flash ROM-kaart) op een apparaat. |
| IWMDRMDeviceApp- | Hiermee kan een toepassing metingen, licentiesynchronisatie en update van drm-onderdelen van een apparaat uitvoeren. |
| IWMDRMDeviceApp2- | Breidt IWMDRMDeviceApp- uit door een nieuwe versie van de methode QueryDeviceStatus op te geven. |
Callback-interfaces
De volgende optionele interfaces worden door een toepassing geïmplementeerd om de voortgang van een asynchrone aanvraag, zoals een lees- of schrijfaanvraag, bij te houden.
| Interface | Beschrijving |
|---|---|
| IWMDMNotification- | Hiermee kunnen toepassingen en serviceproviders meldingen ontvangen wanneer apparaten of geheugenopslag (zoals RAM-kaarten) zijn verbonden of losgekoppeld van de computer. |
| IWMDMOperation2- | Breidt IWMDMOperation- uit door methoden te bieden om uitgebreide kenmerken op te halen en in te stellen. |
| IWMDMOperation3- | Breidt IWMDMOperation uit door een nieuwe methode te bieden voor het overdragen van niet-versleutelde gegevens voor extra efficiëntie. |
| IWMDMOperation- | Hiermee kan een toepassing bepalen hoe gegevens tijdens een bestandsoverdracht worden gelezen van of naar de computer worden geschreven. |
| IWMDMProgress2 | Hiermee wordt de methode IWMDMProgress::End uitgebreid door een statusindicator op te geven. |
| IWMDMProgress3 | Breidt IWMDMProgress2 door aanvullende invoerparameters op te geven om de gebeurtenis-id en contextspecifieke informatie op te geven. |
| IWMDMProgress- | Hiermee kan een toepassing de voortgang van bewerkingen bijhouden, zoals het opmaken van media of bestandsoverdrachten. |
In het volgende diagram ziet u hoe de meeste belangrijke toepassingsinterfaces worden verkregen uit de hoofdinterface van IWMDeviceManager. Een toepassing haalt deze hoofdinterface op door het MediaDevMgr-object te cocreeren, de IComponentAuthenticate interface aan te vragen, het onderdeel te verifiëren en vervolgens de IWMDeviceManager- aan te vragen (deze stappen worden beschreven in De toepassing verifiëren). Zodra deze hoofdinterface is verkregen, wordt IWMDeviceManager::EnumDevices aangeroepen om een object te maken dat IWMDMEnumDevice-implementeert. Andere interfaces worden verkregen door methoden aan te roepen op interfaces in de weergegeven volgorde. Afgeleide interfaces zoals IWMDMDevice2 worden verkregen door QueryInterface- aan te roepen op de basisinterface.
In het volgende diagram worden afgeleide interfaces gelabeld met slashmarkeringen, dus 'IWMDMStorage/2/3' geeft aan IWMDMStorage, IWMDMStorage2en IWMDMStorage3.
Verwante onderwerpen