Metadatenkonstanten
Metadaten sind beschreibende Informationen zu den Inhalten, die auf oder von einem Gerät übertragen werden. In Windows Media Geräte-Manager bestehen Metadaten aus Eigenschaften, wobei jede Eigenschaft ein Name-Wert-Paar ist. Der Name ist immer eine Breitzeichenzeichenfolge. Der Wert ist einer von mehreren definierten Datentypen, die in der WMDM_TAG_DATATYPE-Enumeration beschrieben werden.
Windows Media Geräte-Manager verfügt über vordefinierte allgemeine Eigenschaften, und es wird dringend empfohlen, diese zu verwenden, anstatt neue zu definieren. Für jede vordefinierte Eigenschaft definiert das SDK eine globale Konstante, die die Namenszeichenfolge enthält. Sie können die Wahrscheinlichkeit von Typografiefehlern verringern, indem Sie die globale Konstante verwenden. Beispielsweise wird die konstante g_wszWMDMTitle als "Title" definiert, was der Title-Eigenschaft entspricht.
Die folgenden Metadateneigenschaftenkonstanten wurden für die Verwendung in diesem SDK definiert. Diese werden in mswmdm.h definiert.
Speichermetadatenkonstanten
| Storage-Eigenschaft | BESCHREIBUNG | Windows Media-Geräte-Manager typ | Zugrunde liegender Typ |
|---|---|---|---|
| g_wszAudioWAVECodec | Audiocodec | WMDM_TYPE_DWORD | DWORD |
| g_wszVideoFourCCCodec | Videocodec | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumArt | Gibt an, ob das Gerät Albumart unterstützt oder nicht | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMAlbumArtist | Künstler des Albums des Titels | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAlbumCoverData | Jpeg-Byteblob für Albumart | WMDM_TYPE_BINARY | BYTE* |
| g_wszWMDMAlbumCoverDuration | Dauer des Albumcovers | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverFormat | Albumartformat | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverHeight | Höhe der Albumart | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverSize | Albumartgröße | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverWidth | Albumartbreite | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumTitle | Titel des Albums | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAudioBitDepth | Audiobittiefe | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDBackReferences | Ein Verweis auf das Containerobjekt. Beispielsweise würde ein Audioobjekt diese Eigenschaft verwenden, um auf eine Wiedergabeliste zu verweisen. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAuthor | Inhaltsautor | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAuthorDate | Erstellungsdatum des Inhalts | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMBitrate | Audiobitrate | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBitrateType | Der MTP-Bitratentyp. (Derzeit nicht implementiert.) Gültige Werte sind: MTP_BITRATETYPE_DISCRETE (0x001), die angibt, dass CBR und ein diskreter Satz von Bitraten unterstützt werden. MTP_BITRATETYPE_VARIABLE (0x0002), die die Unterstützung für VBR angibt. MTP_BITRATE_TYPE_FREE (0x0003), die angibt, dass CBR- und Bitratenwerte über einen angegebenen Bereich kontinuierlich sind. |
WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBlockAlignment | Blockausrichtung | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBufferSize | Puffergröße | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBuyNow | Kaufen Sie dieses Album (erforderlich für Albumart) | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMByteBookmark | Ein Lesezeichen, das die zuletzt wiedergegebene oder angezeigte Position in einem Medienobjekt identifiziert. (Dieses Lesezeichen ist ein nullbasierter Byteoffset.) | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMCategory | Ein Textfeld, das das Genre eines Medienelements angibt | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMCodec | Für die zukünftige Verwendung reserviert | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMComposer | Musikkomponist | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMDataLength | Die Datenlänge für das Objekt, auf das verwiesen wird. | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMDataOffset | Ein nullbasierter Offset zum Objekt, auf das verwiesen wird | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMDataUnits | Die Einheiten, die für die Eigenschaften Datenlänge (g_wszWMDMDataLength) und Dateneinheiten (g_wszWMDMDataUnits) verwendet werden. Einheiten werden als Bytes angenommen, wenn diese Eigenschaft nicht festgelegt ist. |
WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMDescription | TV-Serie oder Fotobeschreibung | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMDestinationURL | Die URL, die einem -Objekt zugeordnet ist. Diese Eigenschaft wird in der Regel für ein Medienumwandlungsobjekt (oder ein verwandtes) Objekt verwendet. |
WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMRMId | Für die zukünftige Verwendung reserviert | ||
| g_wszWMDMDevicePlayCount | Wiedergabeanzahl auf dem Gerät | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMDuration | Mediendauer in 100 ns Einheiten | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMEditor | Die E-Mail-Adresse für den Verwaltungs-Editor, der einem Medienobjekt zugeordnet ist. Diese Eigenschaft wird in der Regel verwendet, um den verwaltenden Editor für einen RSS-Kanal zu identifizieren. |
WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMEncodingProfile | Die von einem Gerät unterstützten WMV9-Codierungsprofile | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileAttributes | Die Attribute für ein Dateiobjekt | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMediaClassPrimaryID | Musik, Video, Nicht-Musik-Audio, andere | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileCreationDate | Erstellungsdatum der Datei | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMFileName | Dateiname Entspricht dem Aufrufen von IWMDMStorage::GetName. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileSize | Dateigröße in Bytes. Entspricht dem Aufrufen von IWMDMStorage::GetSize. | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMFormatCode | Formatieren sie Code für das Inhaltsformat. Es sollte ein WMDM_FORMATCODEWert sein. |
WMDM_TYPE_DWORD | WMDM_FORMATCODE |
| g_wszWMDMFrameRate | Bildfrequenz | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMGenre | Genre des Titels | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMHeight | Video- oder Bildhöhe | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMIsProtected | Ob Inhalt DRM-geschützt ist | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMIsRepeat | True, wenn die Episode nicht zum ersten Mal ausgestrahlt wurde | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMKeyFrameDistance | Keyframeabstand | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMLastModifiedDate | Datum/Uhrzeit der letzten Änderung der Datei. Entspricht dem Aufrufen von IWMDMStorage::GetDate. | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMMediaClassSecondaryID | Hörbücher, Musikvideos, Radiosprechen usw. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaCredits | TV-Credits (Schauspieler, Regisseur, Produzenten) | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaGuid | Global eindeutiger Bezeichner für den Medieninhalt | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaOriginalBroadcastDateTime | Datum, an dem diese Episode zum ersten Mal ausgestrahlt wurde | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMMediaOriginalChannel | Kanal, von dem diese Episode aufgezeichnet wurde | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaStationName | Tv-Sender rufen Buchstaben oder Namen | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMetaGenre | Von der primären & sekundären Klassen-ID abgeleiteter Inhaltstyp | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMNonConsumable | Gibt an, ob Inhalte als undurchsichtiges Datenblob auf dem Gerät gespeichert werden. Wenn dies der Fall ist, muss das Gerät das Format nicht verstehen oder rendern. | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMNumChannels | Anzahl der Kanäle | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMObjectBookmark | Ein Lesezeichen (in Millisekunden), das die letzte Position im Medienobjekt angibt, das wiedergegeben oder angezeigt wurde | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMOwner | Die E-Mail-Adresse für den Besitzer eines Medienobjekts | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMParentalRating | Beratungsbewertung | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMPersistentUniqueID | Vom Gerät generierte eindeutige ID für den Speicher | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMPlayCount | Gesamtanzahl der Dateiwiedergabe | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMProviderCopyright | Name des Copyrightinhabers | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMQualitySetting | Qualitätseinstellung | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMSampleRate | Samplingrate | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMScanType | Scantyp | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMSourceURL | Die Quell-URL für ein Medienobjekt | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSubTitle | Titel der TV-Episode | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSubTitleDescription | TV-Episodenbeschreibung | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSyncID | Anwendungsgenerierte GUID für Synchronisierungszwecke | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSyncTime | Gerätezeitstempel beim Kopieren | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMTimeBookmark | Ein Lesezeichen (in Millisekunden), das die zuletzt wiedergegebene oder angezeigte Position angibt | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMTimeToLive | Die Zeit (in Minuten), bis der Inhalt aktualisiert wird | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMTitle | Titel | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMTotalBitrate | Gesamtbitrate | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrack | Track Number (1 99) | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrackMood | Stimmung des Titels | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMUserEffectiveRating | Berechnet aus Benutzer-, Dienstbewertungen und Wiedergabeanzahl | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserLastPlayTime | Zuletzt angehört oder angezeigter Zeitstempel | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMUserRating | Benutzersatzbewertung | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserRatingOnDevice | Benutzersatzbewertung auf dem Gerät geändert | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMVideoBitrate | Videobitrate | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMWebmaster | Die E-Mail-Adresse des für ein Medienobjekt verantwortlichen Webmasters | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMWidth | Video- oder Bildbreite | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMYear | Jahr, in dem das Album veröffentlicht wurde | WMDM_TYPE_STRING | LPCWSTR |
Gerätemetadatenkonstanten
| Geräteeigenschaft | BESCHREIBUNG | PROPVARIANT type(vt) | Kommentare |
|---|---|---|---|
| g_wszWMDMSupportedDeviceProperties | Array von Eigenschaftennamen für vom Gerät unterstützte Eigenschaften | VT_BSTR | VT_ARRAY | |
| g_wszWMDMDeviceFriendlyName | Anzeigename des Geräts | VT_BSTR | |
| g_wszWMDMFormatsSupported | Array von Formatcodes für die vom Gerät unterstützten Formate | VT_UI4 | VT_ARRAY | |
| g_wszWMDMFormatsSupportedAreOrdered | Gibt an, ob das im Array supported-formats zurückgegebene Format entsprechend den Geräteeinstellungen sortiert wird. Wenn diese Eigenschaft auf TRUE festgelegt ist, sollten Anwendungen Inhalte mit den Formatcodes übertragen, die zuerst im Array angezeigt werden. |
VT_BOOL | |
| g_wszWMDMSyncRelationshipID | Von der Anwendung verwendete Synchronisierungsbeziehungs-ID | VT_BSTR | |
| g_wszWMDMDeviceModelName | Device model name (Name des Gerätemodells) | VT_BSTR | |
| g_wszWMDMDeviceFirmwareVersion | Firmware version | VT_UI4 | |
| g_wszWMDMDeviceVendorExtension | Vom Gerät unterstützte Anbietererweiterung | VT_BSTR | |
| g_wszWMDMDeviceProtocol | Protokoll, das für die Kommunikation zwischen Host und Gerät verwendet wird | VT_CLSID | Vordefinierte Werte sind:WMDM_DEVICE_PROTOCOL_MTP, WMDM_DEVICE_PROTOCOL_RAPI, WMDM_DEVICE_PROTOCOL_MSC |
| g_wszWMDMDeviceServiceProviderVendor | ID des Anbieters, der einen Windows Media-Geräte-Manager-Dienstanbieter für das Gerät bereitstellt | VT_CLSID | Vordefinierte Werte sind:WMDM_SERVICE_PROVIDER_VENDOR_MICROSOFT |
| g_wszWMDMCollectionID | Für die zukünftige Verwendung reserviert. | VT_BSTR | |
| g_wszWMDMDeviceRevocationInfo | Die Widerrufsinformationen für ein Gerät. Diese Informationen enthalten Elemente wie die Sperr-URL. |
VT_BSTR | |
| g_wszWMDMSupportedDeviceProperties | Array von Eigenschaftennamen für vom Gerät unterstützte Eigenschaften | VT_BSTR | VT_ARRAY | |
| g_wszWMDMDeviceFriendlyName | Anzeigename des Geräts | VT_BSTR |
Metadatenkonstanten für tragbare Windows-Geräte
| Windows Portable Devices-Eigenschaft | BESCHREIBUNG | PROPVARIANT type(vt) | Kommentare |
|---|---|---|---|
| g_wszWPDPassthroughPropertyValues | Ein binäres großes Objekt (oder BLOB), das zum Festlegen oder Abrufen von Windows Portable Devices-Eigenschaften verwendet wird | WMDM_TYPE_BINARY | Ermöglicht Windows Media Geräte-Manager Clients das Lesen und Schreiben von Windows Portable Device-Eigenschaften, die nicht in Windows Media Geräte-Manager gefunden werden. Beachten Sie, dass auf einige Eigenschaften des tragbaren Windows-Geräts möglicherweise nicht zugegriffen werden kann. |