Dela via

Gränssnitt för program

I det här avsnittet beskrivs gränssnitt som används eller implementeras av program som använder Windows Media Device Manager SDK för att kommunicera med enheter. Termen "program" som används här innebär alla körbara, plugin-program eller COM-objekt som finns på en stationär dator och som behöver kommunikation på hög nivå med en ansluten bärbar enhet. Detta kan omfatta ett media player-program, ett Windows Media Player-plugin-program (om det behöver direkt åtkomst till en bärbar enhet) eller ett COM-objekt för uppspelningsräkningsmätning.

Vissa av dessa gränssnitt implementeras av programmet, medan andra anropas av programmet. Dokumentationen för varje gränssnitt anger om det implementeras eller anropas (och om det implementeras, om det är valfritt eller krävs).

Följande gränssnitt eller klasser används av program.

Gränssnitt eller klass Beskrivning
CSecureChannelClient-klass En hjälpklass som gör det möjligt för program att autentisera sig själva, kryptera och dekryptera data och skapa MAC:er.
IWMDeviceManager Windows Media Device Manager-gränssnittet på den översta nivån för program.
IWMDeviceManager2 Utökar IWMDeviceManager- genom att tillhandahålla avancerade uppräkningsmetoder och andra metoder.
IWMDeviceManager3 Utökar gränssnittet IWMDeviceManager2 genom att tillhandahålla en metod som anger enhetsuppräkningsinställningen.
IWMDMEnhet Tillhandahåller metoder för att undersöka och utforska en enda bärbar enhet.
IWMDMDevice2 Utökar IWMDMEnhet genom att göra det möjligt att få de videoformat som stöds av en enhet, hitta en lagring med namn och använda egenskapssidor.
IWMDMDevice3 Utökar IWMDMDevice2 genom att tillhandahålla metoder för att fråga en enhet efter egenskaper, skicka enhets-I/O-kontrollkoder och även tillhandahålla uppgraderade metoder för att söka efter lagring och hämta funktioner för enhetsformat.
IWMDMDeviceControl Innehåller metoder för att styra enheter.
IWMDMDeviceSession Förbättrar effektiviteten för enhetsåtgärder genom att kombinera flera åtgärder i en session
IWMDMEnumDevice Räknar upp bärbara enheter som är anslutna till en dator.
IWMDMEnumStorage Räknar upp lagring på en enhet.
IWMDMMetaData Anger och hämtar metadataegenskaper (till exempel artist, album, genre och så vidare) för en lagring.
IWMDMObjectInfo Hämtar och anger information som styr hur spelbara filer på enheten hanteras av IWMDMDeviceControl--gränssnittet
IWMDMRevoked Hämtar url:en som uppdaterade komponenter kan laddas ned från, om en överföring misslyckas med ett återkallningsfel.
IWMDMStorage Innehåller metoder för att undersöka och utforska en lagring (fil, mapp, spellista) på en enhet.
IWMDMStorage2 Utökar IWMDMStorage- genom att göra det möjligt att hämta en underordnad lagring efter namn och hämta och ange utökade attribut.
IWMDMStorage3 Utökar IWMDMStorage2- genom att exponera metadata.
IWMDMStorage4 Utökar IWMDMStorage3- genom att tillhandahålla metoder för att hämta en delmängd av tillgängliga metadata för en lagring och för att ange och hämta en lista med referenser till andra lagringsenheter.
IWMDMStorageControl Används för att infoga, ta bort eller flytta filer inom en enhet eller mellan en enhet och datorn.
IWMDMStorageControl2 Utökar IWMDMStorageControl- genom att göra det möjligt att ange namnet på målfilen när innehåll infogas i en lagringsplats.
IWMDMStorageControl3 Utökar IWMDMStorageControl2 genom att göra det möjligt att skicka in en IWMDMMetaData gränssnittspekare.
IWMDMStorageGlobals Innehåller metoder för att hämta global information om ett lagringsmedium (till exempel ett FLASH ROM-kort) på en enhet.
IWMDRMDeviceApp Gör att ett program kan utföra mätning, licenssynkronisering och uppdatering av en enhets DRM-komponenter.
IWMDRMDeviceApp2 Utökar IWMDRMDeviceApp genom att tillhandahålla en ny version av metoden QueryDeviceStatus.

 

Gränssnitt för motringning

Följande valfria gränssnitt implementeras av ett program för att spåra förloppet för en asynkron begäran, till exempel en läs- eller skrivbegäran.

Gränssnitt Beskrivning
IWMDMNotification Gör att program och tjänstleverantörer kan ta emot meddelanden när enheter eller minneslagringar (till exempel RAM-kort) är anslutna eller frånkopplade från datorn.
IWMDMOperation2 Utökar IWMDMOperation- genom att tillhandahålla metoder för att hämta och ange utökade attribut.
IWMDMOperation3 Utökar IWMDMOperation- genom att tillhandahålla en ny metod för att överföra data okrypterade för ökad effektivitet.
IWMDMOperation Gör att ett program kan styra hur data läse från eller skrivs till datorn under en filöverföring.
IWMDMProgress2 Utökar metoden IWMDMProgress::End genom att ange en statusindikator.
IWMDMProgress3 Utökar IWMDMProgress2- genom att tillhandahålla ytterligare indataparametrar för att ange händelse-ID och kontextspecifik information.
IWMDMProgress Tillåter att ett program spårar förloppet för åtgärder, till exempel formatering av media eller filöverföringar.

 

Följande diagram visar hur de flesta viktiga programgränssnitt hämtas från rotgränssnittet IWMDeviceManager gränssnitt. Ett program hämtar det här rotgränssnittet genom att samskapa MediaDevMgr-objektet, begära IComponentAuthenticate-gränssnittet, autentisera komponenten och sedan begära IWMDeviceManager- (de här stegen beskrivs i Autentisera programmet). När det här rotgränssnittet har hämtats anropas IWMDeviceManager::EnumDevices för att skapa ett objekt som implementerar IWMDMEnumDevice. Andra gränssnitt hämtas genom att anropa metoder på gränssnitt i den ordning som visas. Härledda gränssnitt som IWMDMDevice2 hämtas genom att anropa QueryInterface i basgränssnittet.

I följande diagram är härledda gränssnitt märkta med snedstreck, så "IWMDMStorage/2/3" anger IWMDMStorage, IWMDMStorage2och IWMDMStorage3.

diagram som visar hur du hämtar de viktigaste programgränssnitten i Enhetshanteraren för Windows Media.

programmeringsreferens