共用方式為


元數據常數

元數據是傳輸至裝置或從裝置傳送之內容的描述性資訊。 在 Windows Media 裝置管理員 中,元數據是由屬性所組成,其中每個屬性都是名稱/值組。 名稱一律為寬字元字串。 值是數個定義數據類型之一,如WMDM_TAG_DATATYPE列舉中所述

Windows Media 裝置管理員 具有預先定義的通用屬性,強烈建議您改用這些屬性來定義新的屬性。 對於每個預先定義的屬性,SDK 會定義包含名稱字串的全域常數。 您可以使用全域常數來減少印刷錯誤的機會。 例如,常數g_wszWMDMTitle定義為 「Title」,對應至 Title 屬性。

已定義下列元數據屬性常數,以供此 SDK 使用。 這些定義於 mswmdm.h 中。

儲存體 元數據常數

儲存體 屬性 描述 Windows Media 裝置管理員 類型 基礎類型
g_wszAudioWAVECodec 音訊轉碼器 WMDM_TYPE_DWORD DWORD
g_wszVideoFourCCCodec 視訊編解碼器 WMDM_TYPE_DWORD DWORD
g_wszWMDMAlbumArt 裝置是否支援專輯藝術 WMDM_TYPE_BOOL BOOL
g_wszWMDMAlbumArtist 曲目專輯的藝術家 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMAlbumCoverData 專輯藝術 JPEG 位元組 Blob WMDM_TYPE_BINARY 位元組*
g_wszWMDMAlbumCoverDuration 專輯封面持續時間 WMDM_TYPE_DWORD DWORD
g_wszWMDMAlbumCoverFormat 專輯藝術格式 WMDM_TYPE_DWORD DWORD
g_wszWMDMAlbumCoverHeight 專輯藝術高度 WMDM_TYPE_DWORD DWORD
g_wszWMDMAlbumCoverSize 專輯藝術大小 WMDM_TYPE_DWORD DWORD
g_wszWMDMAlbumCoverWidth 專輯藝術寬度 WMDM_TYPE_DWORD DWORD
g_wszWMDMAlbumTitle 曲目專輯標題 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMAudioBitDepth 音訊位深度 WMDM_TYPE_DWORD DWORD
g_wszWMDBackReferences 容器對象的參考。 例如,音訊物件會使用這個屬性來參考播放清單。 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMAuthor 內容作者 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMAuthorDate 內容撰寫日期 WMDM_TYPE_DATE WMDMDATETIME
g_wszWMDMBitrate 音訊比特率 WMDM_TYPE_DWORD DWORD
g_wszWMDMBitrateType MTP 比特率類型。 (目前未實施。有效值為:
MTP_BITRATETYPE_DISCRETE (0x001), 表示支援 CBR 和一組離散的比特率。
MTP_BITRATETYPE_VARIABLE (0x0002), 表示 VBR 的支援。
MTP_BITRATE_TYPE_FREE (0x0003), 表示 CBR 和比特率值在指定的範圍內是連續的。
WMDM_TYPE_DWORD DWORD
g_wszWMDMBlockAlignment 區塊對齊 WMDM_TYPE_DWORD DWORD
g_wszWMDMBufferSize 緩衝區大小 WMDM_TYPE_DWORD DWORD
g_wszWMDMBuyNow 購買此專輯 (專輯藝術所需) WMDM_TYPE_BOOL BOOL
g_wszWMDMByteBookmark 書籤,識別媒體物件中播放或檢視的最後一個位置。 (此書籤是以零起始的位元移。) WMDM_TYPE_QWORD QWORD
g_wszWMDMCategory 文字欄位,指出媒體專案的內容類型 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMCodec 保留供未來使用 WMDM_TYPE_DWORD DWORD
g_wszWMDMComposer 音樂作曲家 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMDataLength 參考對象的數據長度 WMDM_TYPE_QWORD QWORD
g_wszWMDMDataOffset 參考物件的以零起始位移 WMDM_TYPE_QWORD QWORD
g_wszWMDMDataUnits 用於數據長度 (g_wszWMDMDataLength) 和數據單位 (g_wszWMDMDataUnits) 屬性的單位。如果未設定此屬性,則單位會假設為位元組。
WMDM_TYPE_DWORD DWORD
g_wszWMDMDescription 電視連續劇或相片描述 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMDestinationURL 與對象相關聯的 URL。此屬性通常用於媒體轉換 (或相關) 物件。
WMDM_TYPE_STRING LPCWSTR
g_wszWMDMRMId 保留供未來使用
g_wszWMDMDevicePlayCount 裝置上的播放計數 WMDM_TYPE_DWORD DWORD
g_wszWMDMDuration 媒體持續時間,單位為100 ns WMDM_TYPE_QWORD QWORD
g_wszWMDMEditor 與媒體對象相關聯的管理編輯器電子郵件位址。此屬性通常用於識別 RSS 通道的管理編輯器。
WMDM_TYPE_STRING LPCWSTR
g_wszWMDMEncodingProfile 裝置支援的 WMV9 編碼配置檔 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMFileAttributes 檔案物件的屬性 WMDM_TYPE_QWORD QWORD
g_wszWMDMediaClassPrimaryID 音樂、視訊、非音樂音訊、其他 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMFileCreationDate 檔案建立日期 WMDM_TYPE_DATE WMDMDATETIME
g_wszWMDMFileName 檔案名稱 相當於呼叫 IWMDM 儲存體::GetName WMDM_TYPE_STRING LPCWSTR
g_wszWMDMFileSize 檔案大小,以位元組為單位。 相當於呼叫 IWMDM 儲存體::GetSize WMDM_TYPE_QWORD QWORD
g_wszWMDMFormatCode 格式化內容格式的程序代碼。 它應該是 WMDM_FORMATCODE值。
WMDM_TYPE_DWORD WMDM_FORMATCODE
g_wszWMDMFrameRate 畫面播放速率 WMDM_TYPE_DWORD DWORD
g_wszWMDMGenre 曲目流派 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMHeight 視訊或影像高度 WMDM_TYPE_DWORD DWORD
g_wszWMDMIsProtected 內容是否受到DRM保護 WMDM_TYPE_BOOL BOOL
g_wszWMDMIsRepeat 如果不是第一次播出情節,則為 True WMDM_TYPE_BOOL BOOL
g_wszWMDMKeyFrameDistance 主要畫面格距離 WMDM_TYPE_DWORD DWORD
g_wszWMDMLastModifiedDate 上次修改日期/時間檔案。 相當於呼叫 IWMDM 儲存體::GetDate WMDM_TYPE_DATE WMDMDATETIME
g_wszWMDMMediaClassSecondaryID 音訊書籍、音樂視頻、脫口廣播等 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMMediaCredits 電視信用(演員,導演,製片人) WMDM_TYPE_STRING LPCWSTR
g_wszWMDMMediaGuid 媒體內容的全域唯一標識符 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMMediaOriginalBroadcastDateTime 第一集播出日期 WMDM_TYPE_DATE WMDMDATETIME
g_wszWMDMMediaOriginalChannel 該劇從錄製的頻道 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMMediaStationName 電視台來電信件或名稱 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMMetaGenre 衍生自主要和次要類別標識碼的內容類型 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMNonConsumable 內容是否儲存為裝置上的不透明數據 Blob。 如果是,裝置不需要瞭解格式或轉譯它。 WMDM_TYPE_BOOL BOOL
g_wszWMDMNumChannels 通道數目 WMDM_TYPE_DWORD DWORD
g_wszWMDMObjectBookmark 書籤(以毫秒為單位),指定播放或檢視媒體物件中的最後一個位置 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMOwner 媒體對象擁有者的電子郵件位址 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMParentalRating 諮詢評等 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMPersistentUniqueID 裝置產生的記憶體唯一標識符 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMPlayCount 檔案播放的總計數 WMDM_TYPE_DWORD DWORD
g_wszWMDMProviderCopyright 著作權持有人的名稱 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMQualitySetting 質量設定 WMDM_TYPE_DWORD DWORD
g_wszWMDMSampleRate 採樣速率 WMDM_TYPE_DWORD DWORD
g_wszWMDMScanType 掃描類型 WMDM_TYPE_DWORD DWORD
g_wszWMDMSourceURL 媒體物件的來源 URL WMDM_TYPE_STRING LPCWSTR
g_wszWMDMSubTitle 電視劇集標題 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMSubTitleDescription 電視劇集描述 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMSyncID 應用程式產生的 GUID 以供同步處理之用 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMSyncTime 複製時的裝置時間戳 WMDM_TYPE_DATE WMDMDATETIME
g_wszWMDMTimeBookmark 書籤(以毫秒為單位),指定播放或檢視的最後一個位置 WMDM_TYPE_QWORD QWORD
g_wszWMDMTimeToLive 內容更新前的時間(以分鐘為單位) WMDM_TYPE_QWORD QWORD
g_wszWMDMTitle 追蹤標題 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMTotalBitrate 總比特率 WMDM_TYPE_DWORD DWORD
g_wszWMDMTrack 曲目號碼 (1 99) WMDM_TYPE_DWORD DWORD
g_wszWMDMTrackMood 追蹤的心情 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMUserEffectiveRating 從使用者、服務評等和播放計數計算 WMDM_TYPE_DWORD DWORD
g_wszWMDMUserLastPlayTime 上次接聽或檢視時間戳 WMDM_TYPE_DATE WMDMDATETIME
g_wszWMDMUserRating 用戶設定評等 WMDM_TYPE_DWORD DWORD
g_wszWMDMUserRatingOnDevice 裝置上的用戶設定評等已變更 WMDM_TYPE_DWORD DWORD
g_wszWMDMVideoBitrate 視訊比特率 WMDM_TYPE_DWORD DWORD
g_wszWMDMWebmaster 負責媒體對象的網站管理員電子郵件位址 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMWidth 視訊或影像寬度 WMDM_TYPE_DWORD DWORD
g_wszWMDMYear 發行專輯的年份 WMDM_TYPE_STRING LPCWSTR

裝置元數據常數

Device 屬性 描述 PROPVARIANT 類型(vt) 註解
g_wszWMDMSupportedDeviceProperties 裝置所支援屬性的屬性名稱陣列 VT_BSTR |VT_ARRAY
g_wszWMDMDeviceFriendlyName 裝置的易記名稱 VT_BSTR
g_wszWMDMFormatsSupported 裝置所支援格式的格式代碼數位列 VT_UI4 |VT_ARRAY
g_wszWMDMFormatsSupportedAreOrdered 指出支援格式陣列中傳回的格式是否根據裝置喜好設定排序。如果此屬性設定為 TRUE,應用程式應該使用數位中第一個出現的格式代碼來傳輸內容。
VT_BOOL
g_wszWMDMSyncRelationshipID 應用程式所使用的同步關聯性識別碼 VT_BSTR
g_wszWMDMDeviceModelName 裝置型號名稱 VT_BSTR
g_wszWMDMDeviceFirmwareVersion 韌體版本 VT_UI4
g_wszWMDMDeviceVendorExtension 裝置支援的廠商擴充功能 VT_BSTR
g_wszWMDMDeviceProtocol 用於主機與裝置之間通訊的通訊協定 VT_CLSID 預先定義的值為:WMDM_DEVICE_PROTOCOL_MTP,
WMDM_DEVICE_PROTOCOL_RAPI,
WMDM_DEVICE_PROTOCOL_MSC
g_wszWMDMDeviceServiceProviderVendor 為裝置提供 Windows Media 裝置管理員 服務提供者的廠商識別碼 VT_CLSID 預先定義的值為:WMDM_SERVICE_PROVIDER_VENDOR_MICROSOFT
g_wszWMDMCollectionID 保留供未來使用。 VT_BSTR
g_wszWMDMDeviceRevocationInfo 裝置的撤銷資訊。這項資訊會包含吊銷 URL 之類的元素。
VT_BSTR
g_wszWMDMSupportedDeviceProperties 裝置所支援屬性的屬性名稱陣列 VT_BSTR |VT_ARRAY
g_wszWMDMDeviceFriendlyName 裝置的易記名稱 VT_BSTR

Windows 可攜式裝置元數據常數

Windows 可攜式裝置屬性 描述 PROPVARIANT 類型(vt) 註解
g_wszWPDPassthroughPropertyValues 用來設定或擷取 Windows 可攜式裝置屬性的二進位大型物件 (或 BLOB) WMDM_TYPE_BINARY 允許 Windows Media 裝置管理員 用戶端讀取和寫入 Windows Media 裝置管理員 中找不到的 Windows 可攜式裝置屬性。請注意,某些 Windows 可攜式裝置屬性可能無法存取。

程式設計參考