Objecten (Windows Media Format 11 SDK)
[De functie die is gekoppeld aan deze pagina, Windows Media Format 11 SDK, is een verouderde functie. Het is vervangen door Source Reader en Sink Writer. Bronlezer en Sink Writer zijn geoptimaliseerd voor Windows 10 en Windows 11. Microsoft raadt ten zeerste aan om nieuwe code te gebruiken bronlezer en Sink Writer- in plaats van Windows Media Format 11 SDK, indien mogelijk. Microsoft stelt voor dat bestaande code die gebruikmaakt van de verouderde API's, indien mogelijk opnieuw worden geschreven om de nieuwe API's te gebruiken.]
De Windows Media Format SDK maakt gebruik van verschillende objecten voor het lezen, schrijven, bewerken en indexeren van ASF-bestanden en voor het maken en bewerken van profielen. Elk object ondersteunt een aantal interfaces. Sommige interfaces worden ondersteund in meerdere objecten. In deze gevallen worden eventuele verschillen in de implementatie besproken in de naslagsectie voor de interface.
De objecten in de Windows Media Format SDK zijn compatibel met COM. Om de ontwikkeling te vereenvoudigen, heeft elk object een bijbehorende functie of methode voor het maken. U moet objecten maken met behulp van de functie voor maken of methode in plaats van de COM-functie handmatig te gebruiken CoCreateInstance.
Sommige interfaces hebben een nummer toegevoegd aan hun namen, zoals IWMProfile2 en IWMWriter3. In elk geval nemen de genummerde versies alle methoden van de eerdere versies over en voegen nieuwe functionaliteit toe.
Op elke objectpagina van deze verwijzing worden de interfaces die zijn opgenomen in het hoofd-COM-object eerst weergegeven, gevolgd door callback-interfaces die door de toepassing moeten worden geïmplementeerd.
De volgende tabel bevat de objecten die door deze SDK worden ondersteund met een beschrijving van de functionaliteit van elk object en de functie die wordt gebruikt om deze te maken.
| Object | Beschrijving | Functie Maken |
|---|---|---|
| back-upherstelfunctie | Hiermee maakt u een back-up van licenties, meestal op verwisselbare media, en herstelt u deze licenties vervolgens op een andere computer. | WMCreateBackupRestorer- |
| apparaatregistratie | Hiermee beheert u de database voor apparaatregistratie, die vermeldingen bevat voor apparaten voor het afspelen van media die beschikbaar zijn via een netwerkverbinding. | WMCreateDeviceRegistration- |
| DRM-transcryptor | Converteert mediagegevens die met DRM zijn beveiligd in een gegevensstroom die kan worden verzonden naar apparaten die gebruikmaken van het Protocol Windows Media DRM 10 voor netwerkapparaten. | WMCreateDRMTranscryptor- |
| Indexeerfunctie | Hiermee maakt u een index voor ASF-bestanden om zoeken in bestanden met videostreams mogelijk te maken. | WMCreateIndexer- |
| agent voor licentieintrekking | Beheert het intrekken van licenties. | WMCreateLicenseRevocationAgent |
| Metagegevenseditor | Hiermee bewerkt u metagegevens in een ASF-bestandsheader. | WMCreateEditor |
| Profile Manager- | Biedt interfaces voor het maken, laden en opslaan van profielen. Een profiel is vereist voor het schrijven van een ASF-bestand. | WMCreateProfileManager |
| Lezer | Leest ASF-bestanden. Dit object maakt gebruik van een asynchroon aanroepend model voor de bewerkingen. | WMCreateReader- |
| synchrone lezer | Leest ASF-bestanden met synchrone aanroepen. | WMCreateSyncReader- |
| Writer- | Schrijft ASF-bestanden. | WMCreateWriter- |
| Writer-bestandssink | Hiermee bepaalt u ASF-bestanden die zijn geschreven door het writer-object. | WMCreateWriterFileSink |
| Writer Network Sink- | Hiermee bepaalt u livenetwerkstreaming van ASF-bestanden die zijn geschreven door het writer-object. | WMCreateWriterNetworkSink |
| Writer Push Sink- | Hiermee bepaalt u de levering van streaming-inhoud aan publicerende servers. | WMCreateWriterPushSink |
De volgende tabel bevat objecten die afhankelijk zijn van andere objecten. Deze objecten worden gemaakt op basis van methoden van bestaande objecten.
| Object | Beschrijving | Methode voor maken |
|---|---|---|
| bandbreedte delen | Beheert gegevens over het delen van bandbreedte in een profiel. Er kunnen meer dan één object voor het delen van bandbreedte bestaan voor een profiel. Er zijn verschillende methoden voor het maken van een object voor het delen van bandbreedte, afhankelijk van of u een nieuw object voor het delen van bandbreedte wilt maken of toegang wilt krijgen tot een bestaand object. |
IWMProfile3::CreateNewBandwidthSharingOR IWMProfile3::GetBandwidthSharing |
| Buffer | Bevat een mediavoorbeeld en eventuele bijbehorende extensies voor gegevenseenheden. Wordt gebruikt voor zowel het schrijven als lezen van voorbeelden. |
IWMWriter::AllocateSampleOR IWMReaderAllocatorEx::AllocateForOutputEx OF IWMReaderAllocatorEx::AllocateForStreamEx OF Automatisch gemaakt door het lezerobject of synchrone lezerobject voor voorbeeldlevering. |
| eigenschappen van invoermedia | Hiermee beheert u de eigenschappen van een invoer. Er kan één invoereigenschappenobject bestaan voor elke invoer. | IWMWriter::GetInputProps |
| wederzijdse uitsluiting | Beheert wederzijdse uitsluitingsgegevens in een profiel. Veelvoorkomende toepassingen voor wederzijdse uitsluiting zijn inhoud met meerdere bitsnelheid en soundtracks in verschillende talen. Er zijn verschillende methoden voor het maken van een object voor wederzijdse uitsluiting, afhankelijk van of u een nieuw object voor wederzijdse uitsluiting wilt maken of toegang wilt krijgen tot een bestaand object. |
IWMProfile::CreateNewMutualExclusionOR IWMProfile::GetMutualExclusion |
| eigenschappen van uitvoermedia | Beheert de eigenschappen van een uitvoer. Er kan één object voor uitvoermedia-eigenschappen bestaan voor elke uitvoer. Deze objecten kunnen worden gemaakt door de lezer of door de synchrone lezer |
IWMReader::GetOutputPropsOR IWMSyncReader::GetOutputProps |
| profiel | Bevat de gegevens in een profiel terwijl deze worden gemanipuleerd. Profielobjecten worden gemaakt wanneer het profiel moet worden bewerkt. Er zijn verschillende methoden voor het maken van een profielobject, afhankelijk van of u een nieuw profiel wilt maken of toegang wilt krijgen tot een bestaand profiel. |
IWMProfileManager::CreateEmptyProfileOR IWMProfileManager::LoadProfileByData- OF IWMProfileManager::LoadProfileByID OF IWMProfileManager::LoadSystemProfile |
| Stream Configuration- | Hiermee beheert u de eigenschappen van een stream binnen een profiel. Stream-configuratieobjecten worden op elk gewenst moment gemaakt door streamobjecten die u nodig hebt om toegang te krijgen tot de informatie over een stream. Er zijn verschillende methoden voor het maken van een streamconfiguratieobject, afhankelijk van of u een nieuwe stream of toegang en bestaande wilt maken. |
IWMProfile::CreateNewStreamOR IWMProfile::GetStream OF IWMProfile::GetStreamByNumber |
| Stream Prioritization | Onderhoudt de lijst met streamprioriteit voor een profiel. De streams worden verwijderd in volgorde van toenemende prioriteit als de beschikbare bandbreedte wordt beperkt. Er kan slechts één stream prioriteringsobject in een profiel zijn. | IWMProfile3::CreateNewStreamPrioritization |