MSWebDVD イベント
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
注意
このコンポーネントは、Microsoft Windows 2000、Windows XP、および Windows Server 2003 オペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。
注意
この API は非推奨です。 DirectShow での DVD の再生とナビゲーションの詳細については、「 DVD アプリケーション」を参照してください。
MSWebDVD Microsoft® ActiveX® コントロールは、さまざまな種類の内部イベントが発生したとき、またはディスク上で特定の情報が検出されたときに、アプリケーションに通知します。
ほとんどのイベントは、ユーザー操作 (UOP) コントロールに関連しています。 DVD 作成者はディスクをエンコードして、任意の DVD コマンド ( PlayForwards、 Pause、 ShowMenu など) をいつでも無効にすることができます。 たとえば、ほとんどのディスクでは、FBI の警告の再生中にユーザーが早送りしたりメニューを表示したりすることはできません。 警告が終了すると、ディスクはこれらの操作を許可します。 UOP イベントを処理することで、アプリケーションはユーザー インターフェイスを更新して、ディスクで現在許可されているコマンドをユーザーに表示できます。これを行う最も一般的な方法は、ボタンを無効にすることで行います。 たとえば、 アプリケーションが bEnabled を FALSE に設定した PlayForwards イベントを受け取った場合は、[再生] ボタンを無効にすることができます。 bEnabled が TRUE に設定されたイベントを受け取ったら、もう一度ボタンを有効にすることができます。
UOP コントロールに関連しないイベントは 3 つあります。 DVDNotify イベントは、EventCode パラメーターで識別されるさまざまな種類の DVD 関連イベントをアプリケーションに通知します。 一部のイベントには、 Param1 パラメーターと Param2 パラメーターに追加情報があります。 ReadyStateChange イベントは、すべての ActiveX コントロールに共通のプロパティである MSWebDVD ReadyState プロパティの変更をアプリケーションに通知します。 UpdateOverlay イベントは、ウィンドウレス モードで MSWebDVD をホストしている場合にのみ、アプリケーションに送信されます。 アプリケーションは、全画面表示モードでビデオの四角形の上にフローティング ボタンを表示している場合にのみ、このイベントに応答する必要があります。
| event | 説明 |
|---|---|
| ChangeCurrentAngle | ディスクが角度の変更を有効または無効にしたときに送信されます。 |
| ChangeCurrentAudioStream | ディスクがオーディオ ストリームの変更を有効または無効にしたときに送信されます。 |
| ChangeCurrentSubpictureStream | ChangeCurrentSubpictureStream コマンドが有効または無効になったときに送信されます。 |
| DVDNotify | さまざまな DVD イベントとディスク命令をアプリケーションに通知します。 |
| PauseOn | [一時停止] コマンドが有効または無効になったときに送信されます。 |
| PlayAtTime | PlayAtTime コマンドが有効または無効になったときに送信されます。 |
| PlayAtTimeInTitle | PlayAtTimeInTitle コマンドが有効または無効になったときに送信されます。 |
| PlayBackwards | PlayBackwards コマンドが有効または無効になったときに送信されます。 |
| PlayChapter | PlayChapter コマンドが有効または無効になったときに送信されます。 |
| PlayChapterInTitle | PlayChapterInTitle コマンドが有効または無効になったときに送信されます。 |
| PlayForwards | PlayForwards コマンドが有効または無効になったときに送信されます。 |
| PlayNextChapter | PlayNextChapter コマンドが有効または無効になったときに送信されます。 |
| PlayPrevChapter | PlayPrevChapter コマンドが有効または無効になったときに送信されます。 |
| PlayTitle | PlayTitle コマンドが有効または無効になったときに送信されます。 |
| ReadyStateChange | MSWebDVD コントロールの ReadyState プロパティが変更されたときに送信されます。 |
| ReplayChapter | ReplayChapter コマンドが有効または無効になったときに送信されます。 |
| 再開 | Resume コマンドが有効または無効になったときに送信されます。 |
| ReturnFromSubmenu | ReturnFromSubmenu コマンドが有効または無効になったときに送信されます。 |
| SelectOrActivatButton | ディスクがメニュー ボタンの選択またはアクティブ化を有効または無効にしたときに送信されます。 |
| ShowMenu | ディスクがメニューの表示を有効または無効にしたときに送信されます。 |
| StillOff | StillOff コマンドが有効または無効になったときに送信されます。 |
| 停止 | Stop コマンドが有効または無効になったときに送信されます。 |
| UpdateOverlay | オーバーレイ サーフェスが移動またはサイズ変更されたか、カラー キーが変更されたときに送信されます。 |
関連トピック