ホーム › Media.MediaPlayer › IWMPContentContainer

IWMPContentContainer

COM

📘 Microsoft Learn (日本語) · English

IIDad7f4d9c-1a9f-4ed2-9815-ecc0b58cb616継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

メモこのセクションでは、オンラインストアでの使用を想定して設計された機能について説明します。

メソッド 6

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetID(DWORD* pContentID)

メモこのセクションでは、オンラインストアでの使用を想定して設計された機能について説明します。この機能をオンラインストアの文脈外で使用することはサポートされていません。GetID メソッドは、コンテンツコンテナーが表すアルバムまたはリストの ID を取得します。

pContentID

DWORD*

out

ID を受け取る ULONG へのポインター。

戻り値

このメソッドは HRESULT を返します。値には次の表に示すものが含まれますが、これらに限定されません。

戻り値	説明
S_OK	メソッドは成功しました。

解説(Remarks)

ここでのリストとは、オンラインストアがバンドルとして提供するトラックのセットを指します。オンラインストアは、リスト全体に対して 1 つの ID と価格を提供します。

コンテナーがアルバムまたはリストを表していない場合、このメソッドは -1 を取得します。

vtbl 4 HRESULT GetPrice(LPWSTR* pbstrPrice)

メモこのセクションでは、オンラインストアでの使用を想定して設計された機能について説明します。

pbstrPrice

LPWSTR*

out

価格、または次の定数のいずれかを受け取る BSTR へのポインター。

文字列	説明
g_szContentPrice_Unknown	コンテンツの価格は不明です。
g_szContentPrice_CannotBuy	コンテンツは購入できません。
g_szContentPrice_Free	コンテンツは無料です。

戻り値

このメソッドは HRESULT を返します。値には次の表に示すものが含まれますが、これらに限定されません。

戻り値	説明
S_OK	メソッドは成功しました。

解説(Remarks)

pbstrPrice で返される文字列の形式は、オンラインストアのみが認識します。Windows Media Player は価格文字列を表示しますが、解釈は行いません。Windows Media Player とコンテンツパートナーのプラグインが価格情報をやり取りする方法の詳細については、Purchasing Media Content を参照してください。

コンテンツコンテナーがアルバムまたはリストを表していない場合、このメソッドは g_szContentPrice_Unknown を取得します。

vtbl 5 HRESULT GetType(LPWSTR* pbstrType)

メモこのセクションでは、オンラインストアでの使用を想定して設計された機能について説明します。この機能をオンラインストアの文脈外で使用することはサポートされていません。GetType メソッドは、コンテンツコンテナーの種類を取得します。

pbstrType

LPWSTR*

out

次のいずれかの値を受け取る BSTR へのポインター。

値	説明
g_szCPAlbumID	コンテンツコンテナーにはアルバムが含まれます。
g_szCPListID	コンテンツコンテナーにはリストが含まれます。ここでのリストとは、オンラインストアがバンドルとして提供するトラックのセットを指します。オンラインストアは、リスト全体に対して 1 つの ID と価格を提供します。
g_szUnknownLocation	コンテンツコンテナーには個々のトラックのセットが含まれます。

戻り値

このメソッドは HRESULT を返します。値には次の表に示すものが含まれますが、これらに限定されません。

戻り値	説明
S_OK	メソッドは成功しました。

vtbl 6 HRESULT GetContentCount(DWORD* pcContent)

メモこのセクションでは、オンラインストアでの使用を想定して設計された機能について説明します。

pcContent

DWORD*

out

カウントを受け取る ULONG へのポインター。

戻り値

このメソッドは HRESULT を返します。値には次の表に示すものが含まれますが、これらに限定されません。

戻り値	説明
S_OK	メソッドは成功しました。

vtbl 7 HRESULT GetContentPrice(DWORD idxContent, LPWSTR* pbstrPrice)

メモこのセクションでは、オンラインストアでの使用を想定して設計された機能について説明します。

idxContent

DWORD

価格を取得するメディア項目の 0 から始まるインデックスを指定します。

pbstrPrice

LPWSTR*

out

価格、または次の定数のいずれかを受け取る BSTR へのポインター。

文字列	説明
g_szContentPrice_Unknown	コンテンツの価格は不明です。
g_szContentPrice_CannotBuy	コンテンツは購入できません。
g_szContentPrice_Free	コンテンツは無料です。

戻り値

このメソッドは HRESULT を返します。値には次の表に示すものが含まれますが、これらに限定されません。

戻り値	説明
S_OK	メソッドは成功しました。

解説(Remarks)

vtbl 8 HRESULT GetContentID(DWORD idxContent, DWORD* pContentID)

メモこのセクションでは、オンラインストアでの使用を想定して設計された機能について説明します。

idxContent	DWORD	in	コンテナー内のメディア項目の 0 から始まるインデックスを指定します。
pContentID	DWORD*	out	メディア項目の ID を受け取る ULONG へのポインター。

戻り値

このメソッドは HRESULT を返します。値には次の表に示すものが含まれますが、これらに限定されません。

戻り値	説明
S_OK	メソッドは成功しました。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IWMPContentContainer "{AD7F4D9C-1A9F-4ED2-9815-ECC0B58CB616}"
#usecom global IWMPContentContainer IID_IWMPContentContainer "{}"
#comfunc global IWMPContentContainer_GetID            3 var
#comfunc global IWMPContentContainer_GetPrice         4 var
#comfunc global IWMPContentContainer_GetType          5 var
#comfunc global IWMPContentContainer_GetContentCount  6 var
#comfunc global IWMPContentContainer_GetContentPrice  7 int,var
#comfunc global IWMPContentContainer_GetContentID     8 int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IWMPContentContainer "{AD7F4D9C-1A9F-4ED2-9815-ECC0B58CB616}"
#usecom global IWMPContentContainer IID_IWMPContentContainer "{}"
#comfunc global IWMPContentContainer_GetID            3 sptr
#comfunc global IWMPContentContainer_GetPrice         4 sptr
#comfunc global IWMPContentContainer_GetType          5 sptr
#comfunc global IWMPContentContainer_GetContentCount  6 sptr
#comfunc global IWMPContentContainer_GetContentPrice  7 int,sptr
#comfunc global IWMPContentContainer_GetContentID     8 int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。