元數據常數
元數據是傳輸至裝置或從裝置傳送之內容的描述性資訊。 在 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 可攜式裝置屬性可能無法存取。 |