CMediaControl-Klasse
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Die CMediaControl -Klasse bietet die Basisklassenbehandlung der IDispatch-Methoden des IMediaControl mit zwei Schnittstellen. Die Eigenschaften und Methoden der IMediaControl-Schnittstelle bleiben als reine virtuelle.
In der Regel ist der Filterdiagramm-Manager das einzige Objekt, das die IMediaControl-Schnittstelle implementiert. (Filter implementieren die IMediaFilter-Schnittstelle , die von IBaseFilter geerbt wird, um Steuerungsbefehle vom Filterdiagramm-Manager zu empfangen.) Daher ist diese Klassenbibliothek für das Filtern von Entwicklern nur begrenzt geeignet.
Die Memberfunktionen CMediaControl::GetIDsOfNames, CMediaControl::GetTypeInfo, CMediaControl::GetTypeInfoCount und CMediaControl::Invoke sind Standardimplementierungen der IDispatch-Methoden , die die CBaseDispatch-Klasse (und eine Typbibliothek) verwenden, um die Befehle zu analysieren und an die reinen virtuellen Methoden der IMediaControl-Schnittstelle zu übergeben.
Die in control.odl definierten IMediaControl-Methoden werden als reine virtuelle Methoden belassen.
| Elementfunktionen | Beschreibung |
|---|---|
| CMediaControl | Erstellt ein CMediaControl-Objekt . |
| IDispatch-Methoden | Beschreibung |
| GetIDsOfNames | Ordnet einen einzelnen Member und einen optionalen Satz von Parametern einem entsprechenden Satz ganzzahliger Verteilerbezeichner (DISPIDs) zu, die bei nachfolgenden Aufrufen der CMediaControl::Invoke-Methode verwendet werden können. |
| GetTypeInfo | Ruft ein Typinformationsobjekt ab, das die Typinformationen für eine Schnittstelle abrufen kann. |
| GetTypeInfoCount | Ruft die Anzahl der Typinformationsschnittstellen ab, die von einem Objekt bereitgestellt werden. |
| Invoke | Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. |