Metadatenkonstanten
Metadaten sind beschreibende Informationen zu den Inhalten, die an oder von einem Gerät übertragen werden. In Windows Media Device Manager bestehen Metadaten aus Eigenschaften, wobei jede Eigenschaft ein Name-Wert-Paar ist. Der Name ist immer eine Zeichenfolge mit breitem Zeichen. Der Wert ist einer von mehreren definierten Datentypen, die in der WMDM_TAG_DATATYPE-Aufzählung beschrieben werden.
Der Windows Media Device 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, die 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 Device 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 Albumgrafiken unterstützt. | WMDM_TYPE_BOOL | BOOL- |
| g_wszWMDMAlbumArtist | Künstler des Albums von Track | WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMAlbumCoverData | JPEG-Byte-Blob für Albumgrafiken | WMDM_TYPE_BINARY | BYTE*- |
| g_wszWMDMAlbumCoverDuration | Dauer des Albumcovers | WMDM_TYPE_DWORD | DWORD- |
| g_wszWMDMAlbumCoverFormat | Albumartformat | WMDM_TYPE_DWORD | DWORD- |
| g_wszWMDMAlbumCoverHeight | Albumarthöhe | WMDM_TYPE_DWORD | DWORD- |
| g_wszWMDMAlbumCoverSize | Albumartgröße | WMDM_TYPE_DWORD | DWORD- |
| g_wszWMDMAlbumCoverWidth | Breite des Albumformats | WMDM_TYPE_DWORD | DWORD- |
| g_wszWMDMAlbumTitle | Titel des Titels | WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMAudioBitDepth | Audiobittiefe | WMDM_TYPE_DWORD | DWORD- |
| g_wszWMDBackReferences | Ein Verweis auf das Containerobjekt. Ein Audioobjekt würde z. B. diese Eigenschaft verwenden, um auf eine Wiedergabeliste zu verweisen. | WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMAuthor | Inhaltsautor | WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMAuthorDate | Datum des Autors von Inhalten | 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 eine diskrete Gruppe von Bitraten unterstützt werden. MTP_BITRATETYPE_VARIABLE (0x0002), der die Unterstützung für VBR angibt. MTP_BITRATE_TYPE_FREE (0x0003), die angibt, dass CBR- und Bitratewerte über einem angegebenen Bereich fortlaufend 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 Albumgrafiken) | WMDM_TYPE_BOOL | BOOL- |
| g_wszWMDMByteBookmark | Eine Textmarke, die die letzte wiedergegebene oder angezeigte Position in einem Medienobjekt identifiziert. (Diese Textmarke ist ein nullbasierter Byte-Offset.) | WMDM_TYPE_QWORD | QWORD- |
| g_wszWMDMCategory | Ein Textfeld, das das Genre eines Medienelements angibt | WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMCodec | Reserviert für die zukünftige Verwendung | WMDM_TYPE_DWORD | DWORD- |
| g_wszWMDMComposer | Musikkomponist | WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMDataLength | Die Datenlänge für das referenzierte Objekt | WMDM_TYPE_QWORD | QWORD- |
| g_wszWMDMDataOffset | Ein nullbasierter Offset für das referenzierte Objekt | WMDM_TYPE_QWORD | QWORD- |
| g_wszWMDMDataUnits | Die Einheiten, die für die Datenlänge (g_wszWMDMDataLength) und die Dateneinheiteneigenschaften (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 Medien cast (oder verwandtes) Objekt verwendet. |
WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMRMId | Reserviert für die zukünftige Verwendung | ||
| 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 Verwaltungs-Editor für einen RSS-Kanal zu identifizieren. |
WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMEncodingProfile | Die WMV9-Codierungsprofile, die von einem Gerät unterstützt werden | WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMFileAttributes | Die Attribute für ein Dateiobjekt | WMDM_TYPE_QWORD | QWORD- |
| g_wszWMDMediaClassPrimaryID | Musik, Video, Audio ohne Musik, andere | WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMFileCreationDate | Erstellungsdatum der Datei | WMDM_TYPE_DATE | WMDMDATETIME- |
| g_wszWMDMFileName | Dateiname. Entspricht dem Aufrufen IWMDMStorage::GetName. | WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMFileSize | Dateigröße in Byte. Entspricht dem Aufrufen IWMDMStorage::GetSize. | WMDM_TYPE_QWORD | QWORD- |
| g_wszWMDMFormatCode | Formatcode für das Inhaltsformat. Es sollte ein WMDM_FORMATCODEWert sein. |
WMDM_TYPE_DWORD | WMDM_FORMATCODE |
| g_wszWMDMFrameRate | Bildrate | 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 | Gibt an, ob Inhalt DRM geschützt ist | WMDM_TYPE_BOOL | BOOL- |
| g_wszWMDMIsRepeat | True, wenn nicht das erste Mal Episode ausgestrahlt wurde | WMDM_TYPE_BOOL | BOOL- |
| g_wszWMDMKeyFrameDistance | Keyframeabstand | WMDM_TYPE_DWORD | DWORD- |
| g_wszWMDMLastModifiedDate | Die Datums-/Uhrzeitdatei wurde zuletzt geändert. Entspricht dem Aufrufen IWMDMStorage::GetDate. | WMDM_TYPE_DATE | WMDMDATETIME- |
| g_wszWMDMMediaClassSecondaryID | Hörbücher, Musikvideos, Talk radio usw. | WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMMediaCredits | TV-Credits (Schauspieler, Regisseur, Produzenten) | WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMMediaGuid | Globally unique identifier for the media content | WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMMediaOriginalBroadcastDateTime | Datum, an dem die Episode erstmals ausgestrahlt wurde | WMDM_TYPE_DATE | WMDMDATETIME- |
| g_wszWMDMMediaOriginalChannel | Kanal, von dem diese Episode aufgezeichnet wurde | WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMMediaStationName | Telefonanrufe oder Name des Fernsehsenders | 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 undurchsichtige Daten-BLOB auf dem Gerät gespeichert werden. In diesem Fall 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 | Eine Textmarke (in Millisekunden), die die letzte Position des Medienobjekts 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 | Eine Textmarke (in Millisekunden), die die letzte 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 nachverfolgen | WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMTotalBitrate | Bitrate insgesamt | WMDM_TYPE_DWORD | DWORD- |
| g_wszWMDMTrack | Track Number (1 99) | WMDM_TYPE_DWORD | DWORD- |
| g_wszWMDMTrackMood | Stimmung der Spur | WMDM_TYPE_STRING | LPCWSTR- |
| g_wszWMDMUserEffectiveRating | Berechnet aus Benutzer-, Dienstbewertungen und Wiedergabeanzahl | WMDM_TYPE_DWORD | DWORD- |
| g_wszWMDMUserLastPlayTime | Zuletzt angehörte oder angezeigte 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 Webmasters, der für ein Medienobjekt verantwortlich ist | 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
| Device-Eigenschaft | Beschreibung | PROPVARIANT-Typ(vt) | Kommentare |
|---|---|---|---|
| g_wszWMDMSupportedDeviceProperties | Array von Eigenschaftennamen für eigenschaften, die vom Gerät unterstützt werden | VT_BSTR | VT_ARRAY | |
| g_wszWMDMDeviceFriendlyName | Anzeigename des Geräts | VT_BSTR | |
| g_wszWMDMFormatsSupported | Array von Formatcodes für die formate, die vom Gerät unterstützt werden | VT_UI4 | VT_ARRAY | |
| g_wszWMDMFormatsSupportedAreOrdered | Gibt an, ob das im Array unterstützte Formate zurückgegebene Format entsprechend der Geräteeinstellung sortiert wird. Wenn diese Eigenschaft auf TRUEfestgelegt ist, sollten Anwendungen Inhalte mithilfe der Formatcodes übertragen, die zuerst im Array angezeigt werden. |
VT_BOOL | |
| g_wszWMDMSyncRelationshipID | Synchronisierungsbeziehungs-ID, die von der Anwendung verwendet wird | VT_BSTR | |
| g_wszWMDMDeviceModelName | Gerätemodellname | VT_BSTR | |
| g_wszWMDMDeviceFirmwareVersion | Firmwareversion | VT_UI4 | |
| g_wszWMDMDeviceVendorExtension | Vom Gerät unterstützte Anbietererweiterung | VT_BSTR | |
| g_wszWMDMDeviceProtocol | Protokoll für die Kommunikation zwischen Host und Gerät | 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 Device Manager-Dienstanbieter für das Gerät bereitstellt | VT_CLSID | Vordefinierte Werte sind:WMDM_SERVICE_PROVIDER_VENDOR_MICROSOFT |
| g_wszWMDMCollectionID | Reserviert für die zukünftige Verwendung. | VT_BSTR | |
| g_wszWMDMDeviceRevocationInfo | Die Sperrinformationen für ein Gerät. Diese Informationen enthalten Elemente wie die Sperr-URL. |
VT_BSTR | |
| g_wszWMDMSupportedDeviceProperties | Array von Eigenschaftennamen für eigenschaften, die vom Gerät unterstützt werden | 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-Typ(vt) | Kommentare |
|---|---|---|---|
| g_wszWPDPassthroughPropertyValues | Ein binäres großes Objekt (oder BLOB), das zum Festlegen oder Abrufen von Eigenschaften für tragbare Windows-Geräte verwendet wird | WMDM_TYPE_BINARY | Ermöglicht Windows Media Device Manager-Clients, Windows Portable Device-Eigenschaften zu lesen und zu schreiben, die in Windows Media Device Manager nicht gefunden werden.Beachten Sie, dass auf einige Windows Portable Device-Eigenschaften möglicherweise nicht zugegriffen werden kann. |