IWMPEvents3
COM公式ドキュメント
IWMPEvents3 インターフェイスは、Windows Media Player 11 コントロールから発生するイベントへのアクセスを提供します。これにより、このコントロールを埋め込んだアプリケーションがこれらのイベントに応答できます。
メソッド 11
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
CdromRipStateChange イベントは、CD のリッピング操作の状態が変化したときに発生します。
| pCdromRip | IWMPCdromRip* | in | エラーを発生させたリッピング操作を表す IWMPCdromRip インターフェイスへのポインター。 |
| wmprs | WMPRipState | in | 新しい状態を示す WMPRipState 列挙値。 |
解説(Remarks)
このイベントは、_WMPOCXEvents インターフェイスを使用して IDispatch イベントシンク経由で処理することもできます。
Windows Media Player 10 Mobile: このイベントはサポートされていません。
CdromRipMediaError イベントは、CD から個々のトラックをリッピングしている間にエラーが発生したときに起きます。
| pCdromRip | IWMPCdromRip* | in | エラーを発生させたリッピング操作を表す IWMPCdromRip インターフェイスへのポインター。 |
| pMedia | IDispatch* | in | エラーを発生させたメディア項目を表す IDispatch インターフェイスへのポインター。このポインターを通じて QueryInterface を呼び出し、IWMPMedia へのポインターを取得します。 |
解説(Remarks)
このイベントは、_WMPOCXEvents インターフェイスを使用して IDispatch イベントシンク経由で処理することもできます。
Windows Media Player 10 Mobile: このイベントはサポートされていません。
CdromBurnStateChange イベントは、CD の書き込み操作の状態が変化したときに発生します。
| pCdromBurn | IWMPCdromBurn* | in | イベントを発生させた書き込み操作を表す IWMPCdromBurn インターフェイスへのポインター。 |
| wmpbs | WMPBurnState | in | 新しい状態を示す WMPBurnState 列挙値。 |
解説(Remarks)
このイベントは、_WMPOCXEvents インターフェイスを使用して IDispatch イベントシンク経由で処理することもできます。
Windows Media Player 10 Mobile: このイベントはサポートされていません。
CdromBurnMediaError イベントは、個々のメディア項目を CD に書き込んでいる間にエラーが発生したときに起きます。
| pCdromBurn | IWMPCdromBurn* | in | エラーを発生させた書き込み操作を表す IWMPCdromBurn インターフェイスへのポインター。 |
| pMedia | IDispatch* | in | エラーを発生させたメディア項目を表す IDispatch インターフェイスへのポインター。このポインターを通じて QueryInterface を呼び出し、IWMPMedia へのポインターを取得します。 |
解説(Remarks)
一般的なエラーをキャプチャするには、CdromBurnError イベントを処理してください。
このイベントは、_WMPOCXEvents インターフェイスを使用して IDispatch イベントシンク経由で処理することもできます。
Windows Media Player 10 Mobile: このイベントはサポートされていません。
CdromBurnError イベントは、CD の書き込み操作中に一般的なエラーが発生したときに起きます。
| pCdromBurn | IWMPCdromBurn* | in | エラーを発生させた書き込み操作を表す IWMPCdromBurn インターフェイスへのポインター。 |
| hrError | HRESULT | in | イベントを発生させたエラーの HRESULT。 |
解説(Remarks)
メディア固有のエラーをキャプチャするには、CdromBurnMediaError イベントを処理してください。
このイベントは、_WMPOCXEvents インターフェイスを使用して IDispatch イベントシンク経由で処理することもできます。
Windows Media Player 10 Mobile: このイベントはサポートされていません。
LibraryConnect イベントは、ライブラリが利用可能になったときに発生します。
| pLibrary | IWMPLibrary* | in | 接続したライブラリを表す IWMPLibrary インターフェイスへのポインター。 |
解説(Remarks)
このイベントはローカルライブラリでは発生しません。
このイベントは、_WMPOCXEvents インターフェイスを使用して IDispatch イベントシンク経由で処理することもできます。
Windows Media Player 10 Mobile: このイベントはサポートされていません。
LibraryDisconnect イベントは、ライブラリが利用できなくなったときに発生します。
| pLibrary | IWMPLibrary* | in | 切断したライブラリを表す IWMPLibrary インターフェイスへのポインター。 |
解説(Remarks)
このイベントはローカルライブラリでは発生しません。
このイベントは、_WMPOCXEvents インターフェイスを使用して IDispatch イベントシンク経由で処理することもできます。
Windows Media Player 10 Mobile: このイベントはサポートされていません。
FolderScanStateChange イベントは、フォルダー監視操作の状態が変化したときに発生します。
| wmpfss | WMPFolderScanState | in | 新しい状態を示す WMPFolderScanState 列挙値。 |
解説(Remarks)
このイベントは、_WMPOCXEvents インターフェイスを使用して IDispatch イベントシンク経由で処理することもできます。
Windows Media Player 10 Mobile: このイベントはサポートされていません。
StringCollectionChange イベントは、文字列コレクションが変化したときに発生します。
| pdispStringCollection | IDispatch* | in | 変化した文字列コレクションを表す IDispatch インターフェイスへのポインター。QueryInterface を呼び出して IWMPStringCollection へのポインターを取得します。 |
| change | WMPStringCollectionChangeEventType | in | 発生した変更の種類を示す WMPStringCollectionChangeEventType 値。 |
| lCollectionIndex | INT | in | 変化した文字列コレクション項目のインデックス。 |
解説(Remarks)
StringCollectionChange イベントを受信するには、次のようにして文字列コレクションを取得する必要があります。
- IWMPLibrary::get_mediaCollection を呼び出して IWMPMediaCollection インターフェイスを取得します。
- 手順 1 で取得したインターフェイスの getAttributeStringCollection メソッドを呼び出します。
このイベントは、_WMPOCXEvents インターフェイスを使用して IDispatch イベントシンク経由で処理することもできます。
Windows Media Player 10 Mobile: このイベントはサポートされていません。
MediaCollectionMediaAdded イベントは、メディア項目がローカルライブラリに追加されたときに発生します。
| pdispMedia | IDispatch* | in | ローカルライブラリに追加されたメディア項目を表す IDispatch インターフェイスへのポインター。QueryInterface を呼び出して IWMPMedia へのポインターを取得します。 |
解説(Remarks)
このイベントはローカルライブラリでのみ発生します。
このイベントは、_WMPOCXEvents インターフェイスを使用して IDispatch イベントシンク経由で処理することもできます。
Windows Media Player 10 Mobile: このイベントはサポートされていません。
MediaCollectionMediaRemoved イベントは、メディア項目がローカルライブラリから削除されたときに発生します。
| pdispMedia | IDispatch* | in | ローカルライブラリから削除されたメディア項目を表す IDispatch インターフェイスへのポインター。QueryInterface を呼び出して IWMPMedia へのポインターを取得します。 |
解説(Remarks)
このイベントはローカルライブラリでのみ発生します。
このイベントは、_WMPOCXEvents インターフェイスを使用して IDispatch イベントシンク経由で処理することもできます。
Windows Media Player 10 Mobile: このイベントはサポートされていません。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IWMPEvents3 "{1F504270-A66B-4223-8E96-26A06C63D69F}"
#usecom global IWMPEvents3 IID_IWMPEvents3 "{}"
#comfunc global IWMPEvents3_CdromRipStateChange 54 sptr,int
#comfunc global IWMPEvents3_CdromRipMediaError 55 sptr,sptr
#comfunc global IWMPEvents3_CdromBurnStateChange 56 sptr,int
#comfunc global IWMPEvents3_CdromBurnMediaError 57 sptr,sptr
#comfunc global IWMPEvents3_CdromBurnError 58 sptr,int
#comfunc global IWMPEvents3_LibraryConnect 59 sptr
#comfunc global IWMPEvents3_LibraryDisconnect 60 sptr
#comfunc global IWMPEvents3_FolderScanStateChange 61 int
#comfunc global IWMPEvents3_StringCollectionChange 62 sptr,int,int
#comfunc global IWMPEvents3_MediaCollectionMediaAdded 63 sptr
#comfunc global IWMPEvents3_MediaCollectionMediaRemoved 64 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。