Microsoft DirectX 8.0 |
ストリームからメタ データを取得する。 アプリケーションは、このインターフェイスを使って、作成者、タイトル、著作権など、ストリームにエンコードされた情報を取得できる。通常、このインターフェイスは AVI スプリッタや MPEG-1 ストリーム スプリッタなどのパーサー フィルタによって公開される。
ストリーム タイプによっては、フィルタはこのインターフェイスでメソッドのサブセットをサポートすることがある。たとえば、AVI スプリッタは AVI ファイルの INFO チャンクから、著作権、作成者名、およびタイトルを取得する。ほかのメソッドは、E_NOTIMPL を返す。
IUnknown メソッド 説明 QueryInterface サポートされているインターフェイスへのポインタを取得する。 AddRef 参照カウントをインクリメントする。 Release 参照カウントをデクリメントする。 IDispatch メソッド 説明 GetTypeInfoCount このディスプ インターフェイスのタイプ情報が利用できるかどうかを判定する。 GetTypeInfo GetTypeInfoCount が正しく返る場合に、このディスプ インターフェイスのタイプ情報を取得する。 GetIDsOfNames 引数を含めた、プロパティとメソッドのテキスト名を、該当するディスパッチ識別子 (DISPID) に変換する。 Invoke DISPID およびほかの必要なパラメータがある場合に、このディスプ インターフェイスのメソッドを呼び出すか、そのプロパティにアクセスする。 IAMMediaContent メソッド 説明 get_AuthorName 作成者名を取得する。 get_Title タイトルを取得する。 get_Rating レーティングを取得する。 get_Description 内容の説明を取得する。 get_Copyright 著作権情報を取得する。 get_BaseURL 関連 Web コンテンツのベース URL を取得する。 get_LogoURL ロゴの URL を取得する。 get_LogoIconURL ロゴ アイコンの URL を取得する。 get_WatermarkURL ウォーターマークの URL を取得する。 get_MoreInfoURL 内容に関する追加情報の URL を取得する。 get_MoreInfoBannerImage 関連情報バナーのイメージを取得する。 get_MoreInfoBannerURL 関連情報バナーの URL を取得する。 get_MoreInfoText 追加情報をテキストとして取得する。
作成者名を取得する。
構文
HRESULT get_AuthorName( BSTR *pbstrAuthorName );
パラメータ
- pbstrAuthorName
- 情報を持つ BSTR を受け取る変数へのポインタ。
戻り値
HRESULT 値を返す。次の表に示されるいずれかの値。
S_OK 成功。 E_NOTIMPL 実装されていない。 E_OUTOFMEMORY メモリ不足。 VFW_E_NOT_FOUND 項目は見つからなかった。
注意
メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放しなければならない。
タイトルを取得する。
構文
HRESULT get_Title( BSTR *pbstrTitle );
パラメータ
- pbstrTitle
- 情報を持つ BSTR を受け取る変数へのポインタ。
戻り値
HRESULT 値を返す。次の表に示されるいずれかの値。
S_OK 成功。 E_NOTIMPL 実装されていない。 E_OUTOFMEMORY メモリ不足。 VFW_E_NOT_FOUND 項目は見つからなかった。
注意
メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放しなければならない。
レーティングを取得する。
構文
HRESULT get_Rating( BSTR *pbstrRating );
パラメータ
- pbstrRating
- 情報を持つ BSTR を受け取る変数へのポインタ。
戻り値
HRESULT 値を返す。次の表に示されるいずれかの値。
S_OK 成功。 E_NOTIMPL 実装されていない。 E_OUTOFMEMORY メモリ不足。 VFW_E_NOT_FOUND 項目は見つからなかった。
注意
メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放しなければならない。
内容の説明を取得する。
構文
HRESULT get_Description( BSTR *pbstrDescription );
パラメータ
- pbstrDescription
- 情報を持つ BSTR を受け取る変数へのポインタ。
戻り値
HRESULT 値を返す。次の表に示されるいずれかの値。
S_OK 成功。 E_NOTIMPL 実装されていない。 E_OUTOFMEMORY メモリ不足。 VFW_E_NOT_FOUND 項目は見つからなかった。
注意
メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放しなければならない。
著作権情報を取得する。
構文
HRESULT get_Copyright( BSTR *pbstrCopyright );
パラメータ
- pbstrCopyright
- 情報を持つ BSTR を受け取る変数へのポインタ。
戻り値
HRESULT 値を返す。次の表に示されるいずれかの値。
S_OK 成功。 E_NOTIMPL 実装されていない。 E_OUTOFMEMORY メモリ不足。 VFW_E_NOT_FOUND 項目は見つからなかった。
注意
メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放しなければならない。
関連 Web コンテンツのベース URL を取得する。
構文
HRESULT get_BaseURL( BSTR *pbstrBaseURL );
パラメータ
- pbstrBaseURL
- 情報を持つ BSTR を受け取る変数へのポインタ。
戻り値
HRESULT 値を返す。次の表に示されるいずれかの値。
S_OK 成功。 E_NOTIMPL 実装されていない。 E_OUTOFMEMORY メモリ不足。 VFW_E_NOT_FOUND 項目は見つからなかった。
注意
メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放しなければならない。
ロゴの URL を取得する。
構文
HRESULT get_LogoURL( BSTR *pbstrLogoURL );
パラメータ
- pbstrLogoURL
- 情報を持つ BSTR を受け取る変数へのポインタ。
戻り値
HRESULT 値を返す。次の表に示されるいずれかの値。
S_OK 成功。 E_NOTIMPL 実装されていない。 E_OUTOFMEMORY メモリ不足。 VFW_E_NOT_FOUND 項目は見つからなかった。
注意
メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放しなければならない。
ロゴ アイコンの URL を取得する。
構文
HRESULT get_LogoIconURL( BSTR *pbstrLogoURL );
パラメータ
- pbstrLogoURL
- 情報を持つ BSTR を受け取る変数へのポインタ。
戻り値
HRESULT 値を返す。次の表に示されるいずれかの値。
S_OK 成功。 E_NOTIMPL 実装されていない。 E_OUTOFMEMORY メモリ不足。 VFW_E_NOT_FOUND 項目は見つからなかった。
注意
メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放しなければならない。
ウォーターマークの URL を取得する。
構文
HRESULT get_WatermarkURL( BSTR *pbstrWatermarkURL );
パラメータ
- pbstrWatermarkURL
- 情報を持つ BSTR を受け取る変数へのポインタ。
戻り値
HRESULT 値を返す。次の表に示されるいずれかの値。
S_OK 成功。 E_NOTIMPL 実装されていない。 E_OUTOFMEMORY メモリ不足。 VFW_E_NOT_FOUND 項目は見つからなかった。
注意
メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放しなければならない。
内容に関する追加情報の URL を取得する。
構文
HRESULT get_MoreInfoURL( BSTR *pbstrMoreInfoURL );
パラメータ
- pbstrMoreInfoURL
- 情報を持つ BSTR を受け取る変数へのポインタ。
戻り値
HRESULT 値を返す。次の表に示されるいずれかの値。
S_OK 成功。 E_NOTIMPL 実装されていない。 E_OUTOFMEMORY メモリ不足。 VFW_E_NOT_FOUND 項目は見つからなかった。
注意
メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放しなければならない。
関連情報バナーのイメージを取得する。
構文
HRESULT get_MoreInfoBannerImage( BSTR *pbstrMoreInfoBannerImage );
パラメータ
- pbstrMoreInfoBannerImage
- 情報を持つ BSTR を受け取る変数へのポインタ。
戻り値
HRESULT 値を返す。次の表に示されるいずれかの値。
S_OK 成功。 E_NOTIMPL 実装されていない。 E_OUTOFMEMORY メモリ不足。 VFW_E_NOT_FOUND 項目は見つからなかった。
注意
メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放しなければならない。
関連情報バナーの URL を取得する。
構文
HRESULT get_MoreInfoBannerURL( BSTR *pbstrMoreInfoBannerURL );
パラメータ
- pbstrMoreInfoBannerURL
- 情報を持つ BSTR を受け取る変数へのポインタ。
戻り値
HRESULT 値を返す。次の表に示されるいずれかの値。
S_OK 成功。 E_NOTIMPL 実装されていない。 E_OUTOFMEMORY メモリ不足。 VFW_E_NOT_FOUND 項目は見つからなかった。
注意
メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放しなければならない。
追加情報をテキストとして取得する。
構文
HRESULT get_MoreInfoText( BSTR *pbstrMoreInfoText );
パラメータ
- pbstrMoreInfoText
- 情報を持つ BSTR を受け取る変数へのポインタ。
戻り値
HRESULT 値を返す。次の表に示されるいずれかの値。
S_OK 成功。 E_NOTIMPL 実装されていない。 E_OUTOFMEMORY メモリ不足。 VFW_E_NOT_FOUND 項目は見つからなかった。
注意
メソッドが成功した場合、呼び出し元は SysFreeString 関数を呼び出して、返された BSTR を解放しなければならない。