メタデータ定数
メタデータは、デバイス間で転送されるコンテンツに関する説明情報です。 Windows Media Device Manager では、メタデータはプロパティで構成され、各プロパティは名前と値のペアです。 名前は常にワイド文字列です。 この値は、WMDM_TAG_DATATYPE 列挙型で説明されている複数の定義済みデータ型のいずれかです。
Windows Media Device Manager には定義済みの共通プロパティがあるため、新しいプロパティを定義する代わりに使用することを強くお勧めします。 定義済みのプロパティごとに、SDK は名前文字列を含むグローバル定数を定義します。 グローバル定数を使用すると、文字体裁エラーの可能性を減らすことができます。 たとえば、定数g_wszWMDMTitleは、Title プロパティに対応する "Title" として定義されます。
この SDK で使用するために、次のメタデータ プロパティ定数が定義されています。 これらは mswmdm.h で定義されています。
ストレージ メタデータ定数
| Storage プロパティ | 形容 | Windows Media Device Manager の種類 | 基になる型 を する |
|---|---|---|---|
| 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 | BYTE* |
| 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 と個別のビット レート セットがサポートされていることを示します。 VBR のサポートを示す MTP_BITRATETYPE_VARIABLE (0x0002)。 CBR とビット レートの値が指定した範囲にわたって連続していることを示す MTP_BITRATE_TYPE_FREE (0x0003)。 |
WMDM_TYPE_DWORD | DWORD の |
| g_wszWMDMBlockAlignment | ブロックの配置 | WMDM_TYPE_DWORD | DWORD の |
| g_wszWMDMBufferSize | バッファー サイズ | WMDM_TYPE_DWORD | DWORD の |
| g_wszWMDMBuyNow | このアルバムを購入する(アルバムアートに必要) | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMByteBookmark | メディア オブジェクトで最後に再生または表示された位置を識別するブックマーク。 (このブックマークは、0 から始まるバイト オフセットです)。 | 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 | 参照先オブジェクトへの 0 から始まるオフセット | 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 | ファイル名。 IWMDMStorage::GetName呼び出すことと同じです。 | WMDM_TYPE_STRING | LPCWSTR を する |
| g_wszWMDMFileSize | ファイル サイズ (バイト単位)。 IWMDMStorage::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 | 日付/時刻ファイルが最後に変更されました。 IWMDMStorage::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 | プライマリ & セカンダリ クラス ID から派生したコンテンツ タイプ | 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 | デバイスによって生成されたストレージの一意の ID | 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 | メディア オブジェクトを担当する Web マスターの電子メール アドレス | WMDM_TYPE_STRING | LPCWSTR を する |
| g_wszWMDMWidth | ビデオまたは画像の幅 | WMDM_TYPE_DWORD | DWORD の |
| g_wszWMDMYear | アルバムがリリースされた年 | WMDM_TYPE_STRING | LPCWSTR を する |
デバイス メタデータ定数
| Device プロパティ | 形容 | PROPVARIANT type(vt) | コメント |
|---|---|---|---|
| g_wszWMDMSupportedDeviceProperties | デバイスでサポートされるプロパティのプロパティ名の配列 | VT_BSTR |VT_ARRAY | |
| g_wszWMDMDeviceFriendlyName | デバイスのフレンドリ名 | VT_BSTR | |
| g_wszWMDMFormatsSupported | デバイスでサポートされている形式の書式コードの配列 | VT_UI4 |VT_ARRAY | |
| g_wszWMDMFormatsSupportedAreOrdered | サポートされている形式の配列で返される形式が、デバイスの設定に従って並べ替えられたかどうかを示します。このプロパティが true に設定されている場合、アプリケーションは、配列の先頭に表示される書式コードを使用してコンテンツを転送する必要があります。 |
VT_BOOL | |
| g_wszWMDMSyncRelationshipID | アプリケーションで使用される同期関係 ID | 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 Device Manager サービス プロバイダーを提供するベンダーの ID | 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 type(vt) | コメント |
|---|---|---|---|
| g_wszWPDPassthroughPropertyValues | Windows ポータブル デバイスのプロパティを設定または取得するために使用されるバイナリ ラージ オブジェクト (または BLOB) | WMDM_TYPE_BINARY | Windows Media Device Manager クライアントが、Windows Media Device Manager で見つからない Windows ポータブル デバイス プロパティの読み取りと書き込みを行うことができます。一部の Windows ポータブル デバイス プロパティにアクセスできない場合があることに注意してください。 |