Implementieren anderer Funktionen
Sie sollten auf jeden Fall Ihre eigene Implementierung der Render-Funktion schreiben. Es werden mehrere weitere Funktionen bereitgestellt, die auch Memberfunktionen der IWMPEffects-Schnittstelle sind. Einige stellen Ihnen zusätzliche Informationen zur Verfügung, die Sie verwenden können, während andere Windows Media Player automatisch Informationen bereitstellen, die vom Assistenten generiert wurden, z. B. den Namen Ihrer Visualisierung.
Die IWMPEffects-Schnittstelle unterstützt zusätzlich zum Rendern die folgenden Funktionen:
| Funktion | Beschreibung |
|---|---|
| DisplayPropertyPage | Die Standardimplementierung wird vom Assistenten nicht bereitgestellt. |
| GetCapabilities | Ruft die Funktionen Ihrer Visualisierung ab und übergibt sie Windows Media Player. |
| GetCurrentPreset | Der Assistent hat zwei Voreinstellungen erstellt, als er den Code für Ihre Visualisierung generiert hat. Diese Funktion wird aufgerufen, wenn der Skinentwickler den Index der aktuellen Voreinstellung erhalten möchte. Sie möchten die Implementierung dieser Funktion nicht ändern, da sie nur informationen verwendet, die von anderen Funktionen festgelegt wurden. |
| GetPresetCount | Der Assistent hat zwei Voreinstellungen erstellt, als er den Code für Ihre Visualisierung generiert hat. Sie können die Anzahl ändern, indem Sie die Implementierung von GetPresetCount ändern. Weitere Informationen zum Ändern der Voreinstellungen finden Sie unter Voreinstellungen. |
| GetPresetTitle | Der Assistent hat zwei Voreinstellungen erstellt, als er den Code für Ihre Visualisierung generiert hat. Sie können die verwendeten Titel ändern, indem Sie die Implementierung von GetPresetTitle ändern. Weitere Informationen zum Ändern der Voreinstellungen finden Sie unter Voreinstellungen. |
| GetTitle | Ruft den Titel Ihrer Visualisierung ab und übergibt ihn Windows Media Player. Der Assistent hat den Namen Ihres Projekts verwendet, um den Namen zu generieren, der zurücküberkommen wird. |
| GoFullscreen | Die Standardimplementierung wird vom Assistenten nicht bereitgestellt. |
| Mediainfo | Ruft die Anzahl der Audiokanäle und die Abtastrate der aktuell abspielten Audiodaten ab. |
| RenderFullScreen | Die Standardimplementierung wird vom Assistenten nicht bereitgestellt. |
| SetCurrentPreset | Der Assistent hat zwei Voreinstellungen erstellt, als er den Code für Ihre Visualisierung generiert hat. Diese Funktion wird aufgerufen, wenn Windows Media Player in eine benannte Voreinstellung ändern möchte. |
Die IWMPEffects2-Schnittstelle unterstützt die folgenden zusätzlichen Funktionen:
| Funktion | BESCHREIBUNG |
|---|---|
| Erstellen | Beim Rendern in einem Fenster ruft Windows Media Player funktion auf, damit Sie ein neues Fenster für das Rendering erstellen können. |
| Zerstören | Beim Rendern in einem Fenster ruft Windows Media Player Funktion auf, damit Sie das Fenster zerstören können, das Sie beim Aufrufen von Create erstellt haben. |
| NotifyNewMedia | Mit dieser Funktion kann Ihre Visualisierung reagieren, wenn ein neues Medienelement vom Player geladen wurde. |
| OnWindowMessage | Diese Funktion empfängt Windows-Nachrichten vom Player, wenn sie im fensterlosen Modus gerendert wird. |
| RenderWindowed | Diese Funktion wird vom Player anstelle von IWMPEffects::Render aufgerufen, wenn der Player im Fenstermodus gerendert wird. |
| SetCore | Diese Funktion empfängt einen Zeiger auf die IWMPCore-Schnittstelle. |