Delen via


Interfaces voor serviceproviders

In deze sectie worden interfaces beschreven die zijn geïmplementeerd door Windows Media Device Manager-serviceproviders. Serviceproviders voeren het grootste deel van het werkelijke werk uit van de communicatie met een apparaat, omdat ze de meeste Windows Media Device Manager SDK-methoden implementeren die door de toepassing worden aangeroepen.

Serviceproviders hoeven niet alle interfaces te implementeren die in deze sectie worden vermeld. Een mediaapparaat dat geen on-board opslag heeft, implementeert bijvoorbeeld niet de interfaces die worden gebruikt om inhoud te beheren of beschikbaar te maken. Of een methode of interface vereist is, wordt aangegeven op de juiste referentiepagina.

Interface of klasse Beschrijving
CSecureChannelServer Een helperklasse waarmee een serviceprovider of beveiligde inhoudsprovider een toepassing kan verifiëren en MAC-handtekeningen voor beveiligde parameters kan maken.
IMDServiceProvider- Biedt de client (meestal Windows Media Device Manager) een apparaat-enumerator voor de apparaten die door deze serviceprovider worden ondersteund.
IMDServiceProvider2- Breidt IMDServiceProvider uit door een methode te bieden voor het maken van het apparaat met behulp van het apparaatpad.
IMDServiceProvider3- Breidt IMDServiceProvider2 uit door een methode op te geven voor het instellen van de voorkeuren voor de opsomming van het apparaat.
IMDSPDevice- Biedt een koppeling op basis van een exemplaar met een mediaapparaat. Met deze interface kan de client de opslagmedia-inventarisaties voor het apparaat opsommen, informatie over het apparaat ophalen en ondoorzichtige opdrachten (passthrough) naar het apparaat verzenden.
IMDSPDevice2- Breidt IMDSPDevice- uit door methoden te bieden voor het verkrijgen van uitgebreide video-indelingen, het ophalen van PnP-apparaatnamen (Plug and Play), het gebruik van eigenschappenpagina's inschakelen en het mogelijk maken om een aanwijzer naar een opslagmedium te krijgen op basis van de naam. Deze interface is optioneel voor de serviceprovider, maar wordt aanbevolen.
IMDSPDevice3- Breidt IMDSPDevice2- uit door de mogelijkheid te bieden om query-eigenschappen en mogelijkheden van het apparaat op te vragen met betrekking tot een objectindeling.
IMDSPDeviceControl- Biedt methoden voor het beheren van apparaten.
IMDSPDirectTransfer- Hiermee kan Windows Media Device Manager inhoudsoverdracht delegeren naar de serviceprovider. In dit geval voert Windows Media Device Manager geen verwerking van de inhoud uit voordat deze naar de serviceprovider wordt verzonden. De serviceprovider krijgt volledige controle over de bron.
IMDSPEnumDevice- Inventariseert de mediaapparaten die door deze serviceprovider worden ondersteund.
IMDSPEnumStorage- Inventariseert de opslagmedia op een apparaat en de inhoud op een opslagmedium.
IMDSPObject- Bevat methoden voor bewerkingen voor gegevensoverdracht op een opslagobject.
IMDSPObject2- Breidt IMDSPObject- uit door efficiëntere overdracht van gegevens met DRM te bieden.
IMDSPObjectInfo- Hiermee stelt u speellengte, speelpositie, afspeelverschil of totale lengte van afspeelbare objecten op een opslagmedium in of haalt u deze op.
IMDSPRevoked- Haalt de URL op van waaruit bijgewerkte onderdelen kunnen worden gedownload.
IMDSPStorage- Biedt een op exemplaren gebaseerde koppeling met een opslagmedium op een apparaat. Deze interface maakt opslagobjecten, haalt informatie over deze objecten op en biedt toegang tot de IMDSPEnumStorage interface voor het inventariseren van submappen die zijn genest in de huidige opslag.
IMDSPStorage2- Breidt IMDSPStorage- uit door uitgebreide kenmerken op te halen en in te stellen en het mogelijk te maken om een aanwijzer op te halen uit de naam.
IMDSPStorage3- Breidt IMDSPStorage2- uit door ondersteuning van metagegevens.
IMDSPStorage4- Breidt IMDSPStorage3- uit door het ondersteunen van afspeellijstobjecten.
IMDSPStorageGlobals- Haalt globale informatie op over een opslagmedium, zoals de hoeveelheid vrije ruimte en het totale aantal bestanden.

 

In het volgende diagram ziet u hoe u de verschillende interfaces kunt ophalen die zijn geïmplementeerd door een serviceprovider. In dit diagram worden afgeleide interfaces weergegeven in dezelfde tag voor compactheid, zodat IMDServiceProvider/2/3 drie interfaces vertegenwoordigt: IMDServiceProvider, IMDServiceProvider2en IMDServiceProvider3. De weergegeven methoden worden uitgebreid door slechts één van deze interfaces. Afgeleide interfaces worden verkregen door QueryInterface- aan te roepen op de basisinterface van het gemaakte object.

diagram waarin wordt getoond hoe Windows Media Device Manager verwacht interfaces te verkrijgen van een serviceprovider.

Programmeringsreferentie

Windows Media DRM-Implemented Interfaces