メタデータ定数
メタデータは、デバイス間で転送されるコンテンツに関する説明情報です。 Windows Media デバイス マネージャーでは、メタデータはプロパティで構成され、各プロパティは名前と値のペアです。 名前は常にワイド文字列です。 値は、 WMDM_TAG_DATATYPE 列挙体で説明されているいくつかの定義済みデータ型のいずれかです。
Windows Media デバイス マネージャーには定義済みの共通プロパティがあり、新しいプロパティを定義する代わりにそれらを使用することを強くお勧めします。 定義済みのプロパティごとに、SDK は名前文字列を含むグローバル定数を定義します。 グローバル定数を使用すると、文字体裁エラーの可能性を減らすことができます。 たとえば、定数g_wszWMDMTitleは Title プロパティに対応する "Title" として定義されます。
この SDK で使用するために、次のメタデータ プロパティ定数が定義されています。 これらは mswmdm.h で定義されています。
ストレージ メタデータ定数
| Storage プロパティ | 説明 | 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 とビット レートの個別のセットがサポートされていることを示します。 VBR のサポートを示すMTP_BITRATETYPE_VARIABLE (0x0002)。 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 | メディア オブジェクトで再生または表示された最後の位置を識別するブックマーク。 (このブックマークは、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 |
デバイス メタデータ定数
| デバイス プロパティ | 説明 | 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 | Device model name (デバイス モデル名) | VT_BSTR | |
| g_wszWMDMDeviceFirmwareVersion | Firmware version | 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 デバイス マネージャー サービス プロバイダーを提供するベンダーの 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 デバイス マネージャー クライアントが、Windows Media デバイス マネージャーで見つからない Windows ポータブル デバイス プロパティの読み取りと書き込みを行うことができます。一部の Windows ポータブル デバイス プロパティにアクセスできない場合があることに注意してください。 |