Win32 API 日本語リファレンス
ホーム › Media.DirectShow › IAMMediaContent

IAMMediaContent

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IIDfa2aa8f4-8b62-11d0-a520-000000000000継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

IAMMediaContent インターフェイスは、ストリームからメタデータを取得します。

解説(Remarks)

インターフェイス識別子を定義するには、ヘッダーファイル Initguid.h を Qnetwork.h より前、ただし Dshow.h やその他のヘッダーファイルより後にインクルードします:

#include <dshow.h>
#include <initguid.h>
#include <qnetwork.h>
Note Initguid.h がプロジェクト内で一度だけインクルードされるようにしてください。そうしないと、重複した GUID 値に対するリンカーエラーが発生します。

メソッド 13

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_AuthorName(LPWSTR* pbstrAuthorName)

get_AuthorName メソッドは、作成者名を取得します。

pbstrAuthorNameLPWSTR*inout情報を格納した BSTR を受け取る変数へのポインター。

戻り値

HRESULT 値を返します。取り得る値には次の表に示すものが含まれます。

戻り値 説明
S_OK
 成功しました。
E_NOTIMPL
 実装されていません。
E_OUTOFMEMORY
 メモリが不足しています。
VFW_E_NOT_FOUND
 項目が見つかりませんでした。

解説(Remarks)

メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放する必要があります。

vtbl 8 HRESULT get_Title(LPWSTR* pbstrTitle)

get_Title メソッドは、タイトルを取得します。

pbstrTitleLPWSTR*inout情報を格納した BSTR を受け取る変数へのポインター。

戻り値

HRESULT 値を返します。取り得る値には次の表に示すものが含まれます。

戻り値 説明
S_OK
 成功しました。
E_NOTIMPL
 実装されていません。
E_OUTOFMEMORY
 メモリが不足しています。
VFW_E_NOT_FOUND
 項目が見つかりませんでした。

解説(Remarks)

メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放する必要があります。

vtbl 9 HRESULT get_Rating(LPWSTR* pbstrRating)

get_Rating メソッドは、レーティングを取得します。

pbstrRatingLPWSTR*inout情報を格納した BSTR を受け取る変数へのポインター。

戻り値

HRESULT 値を返します。取り得る値には次の表に示すものが含まれます。

戻り値 説明
S_OK
 成功しました。
E_NOTIMPL
 実装されていません。
E_OUTOFMEMORY
 メモリが不足しています。
VFW_E_NOT_FOUND
 項目が見つかりませんでした。

解説(Remarks)

メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放する必要があります。

vtbl 10 HRESULT get_Description(LPWSTR* pbstrDescription)

get_Description メソッドは、コンテンツの説明を取得します。

pbstrDescriptionLPWSTR*inout情報を格納した BSTR を受け取る変数へのポインター。

戻り値

HRESULT 値を返します。取り得る値には次の表に示すものが含まれます。

戻り値 説明
S_OK
 成功しました。
E_NOTIMPL
 実装されていません。
E_OUTOFMEMORY
 メモリが不足しています。
VFW_E_NOT_FOUND
 項目が見つかりませんでした。

解説(Remarks)

メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放する必要があります。

vtbl 11 HRESULT get_Copyright(LPWSTR* pbstrCopyright)

get_Copyright メソッドは、著作権情報を取得します。

pbstrCopyrightLPWSTR*inout情報を格納した BSTR を受け取る変数へのポインター。

戻り値

HRESULT 値を返します。取り得る値には次の表に示すものが含まれます。

戻り値 説明
S_OK
 成功しました。
E_NOTIMPL
 実装されていません。
E_OUTOFMEMORY
 メモリが不足しています。
VFW_E_NOT_FOUND
 項目が見つかりませんでした。

解説(Remarks)

メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放する必要があります。

vtbl 12 HRESULT get_BaseURL(LPWSTR* pbstrBaseURL)

get_BaseURL メソッドは、関連する Web コンテンツのベース URL を取得します。

pbstrBaseURLLPWSTR*inout情報を格納した BSTR を受け取ります。

戻り値

HRESULT 値を返します。取り得る値には次の表に示すものが含まれます。

戻り値 説明
S_OK
 成功しました。
E_NOTIMPL
 実装されていません。
E_OUTOFMEMORY
 メモリが不足しています。
VFW_E_NOT_FOUND
 項目が見つかりませんでした。

解説(Remarks)

メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放する必要があります。

vtbl 13 HRESULT get_LogoURL(LPWSTR* pbstrLogoURL)

get_LogoURL メソッドは、ロゴの URL を取得します。

pbstrLogoURLLPWSTR*inout情報を格納した BSTR を受け取る変数へのポインター。

戻り値

HRESULT 値を返します。取り得る値には次の表に示すものが含まれます。

戻り値 説明
S_OK
 成功しました。
E_NOTIMPL
 実装されていません。
E_OUTOFMEMORY
 メモリが不足しています。
VFW_E_NOT_FOUND
 項目が見つかりませんでした。

解説(Remarks)

メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放する必要があります。

vtbl 14 HRESULT get_LogoIconURL(LPWSTR* pbstrLogoURL)

get_LogoIconURL メソッドは、ロゴアイコンの URL を取得します。

pbstrLogoURLLPWSTR*inout情報を格納した BSTR を受け取る変数へのポインター。

戻り値

HRESULT 値を返します。取り得る値には次の表に示すものが含まれます。

戻り値 説明
S_OK
 成功しました。
E_NOTIMPL
 実装されていません。
E_OUTOFMEMORY
 メモリが不足しています。
VFW_E_NOT_FOUND
 項目が見つかりませんでした。

解説(Remarks)

メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放する必要があります。

vtbl 15 HRESULT get_WatermarkURL(LPWSTR* pbstrWatermarkURL)

get_WatermarkURL メソッドは、ウォーターマークの URL を取得します。

pbstrWatermarkURLLPWSTR*inout情報を格納した BSTR を受け取る変数へのポインター。

戻り値

HRESULT 値を返します。取り得る値には次の表に示すものが含まれます。

戻り値 説明
S_OK
 成功しました。
E_NOTIMPL
 実装されていません。
E_OUTOFMEMORY
 メモリが不足しています。
VFW_E_NOT_FOUND
 項目が見つかりませんでした。

解説(Remarks)

メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放する必要があります。

vtbl 16 HRESULT get_MoreInfoURL(LPWSTR* pbstrMoreInfoURL)

get_MoreInfoURL メソッドは、コンテンツに関する追加情報の URL を取得します。

pbstrMoreInfoURLLPWSTR*inout情報を格納した BSTR を受け取る変数へのポインター。

戻り値

HRESULT 値を返します。取り得る値には次の表に示すものが含まれます。

戻り値 説明
S_OK
 成功しました。
E_NOTIMPL
 実装されていません。
E_OUTOFMEMORY
 メモリが不足しています。
VFW_E_NOT_FOUND
 項目が見つかりませんでした。

解説(Remarks)

メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放する必要があります。

vtbl 17 HRESULT get_MoreInfoBannerImage(LPWSTR* pbstrMoreInfoBannerImage)

get_MoreInfoBannerImage メソッドは、関連情報バナー用の画像を取得します。

pbstrMoreInfoBannerImageLPWSTR*inout情報を格納した BSTR を受け取る変数へのポインター。

戻り値

HRESULT 値を返します。取り得る値には次の表に示すものが含まれます。

戻り値 説明
S_OK
 成功しました。
E_NOTIMPL
 実装されていません。
E_OUTOFMEMORY
 メモリが不足しています。
VFW_E_NOT_FOUND
 項目が見つかりませんでした。

解説(Remarks)

メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放する必要があります。

vtbl 18 HRESULT get_MoreInfoBannerURL(LPWSTR* pbstrMoreInfoBannerURL)

get_MoreInfoBannerURL メソッドは、関連情報バナーの URL を取得します。

pbstrMoreInfoBannerURLLPWSTR*inout情報を格納した BSTR を受け取る変数へのポインター。

戻り値

HRESULT 値を返します。取り得る値には次の表に示すものが含まれます。

戻り値 説明
S_OK
 成功しました。
E_NOTIMPL
 実装されていません。
E_OUTOFMEMORY
 メモリが不足しています。
VFW_E_NOT_FOUND
 項目が見つかりませんでした。

解説(Remarks)

メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放する必要があります。

vtbl 19 HRESULT get_MoreInfoText(LPWSTR* pbstrMoreInfoText)

get_MoreInfoText メソッドは、追加情報をテキストとして取得します。

pbstrMoreInfoTextLPWSTR*inout情報を格納した BSTR を受け取る変数へのポインター。

戻り値

HRESULT 値を返します。取り得る値には次の表に示すものが含まれます。

戻り値 説明
S_OK
 成功しました。
E_NOTIMPL
 実装されていません。
E_OUTOFMEMORY
 メモリが不足しています。
VFW_E_NOT_FOUND
 項目が見つかりませんでした。

解説(Remarks)

メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放する必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IAMMediaContent "{FA2AA8F4-8B62-11D0-A520-000000000000}"
#usecom global IAMMediaContent IID_IAMMediaContent "{}"
#comfunc global IAMMediaContent_get_AuthorName           7 var
#comfunc global IAMMediaContent_get_Title                8 var
#comfunc global IAMMediaContent_get_Rating               9 var
#comfunc global IAMMediaContent_get_Description          10 var
#comfunc global IAMMediaContent_get_Copyright            11 var
#comfunc global IAMMediaContent_get_BaseURL              12 var
#comfunc global IAMMediaContent_get_LogoURL              13 var
#comfunc global IAMMediaContent_get_LogoIconURL          14 var
#comfunc global IAMMediaContent_get_WatermarkURL         15 var
#comfunc global IAMMediaContent_get_MoreInfoURL          16 var
#comfunc global IAMMediaContent_get_MoreInfoBannerImage  17 var
#comfunc global IAMMediaContent_get_MoreInfoBannerURL    18 var
#comfunc global IAMMediaContent_get_MoreInfoText         19 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。