IAMExtTransport::SetEditPropertySet-Methode (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Die SetEditPropertySet
-Methode registriert einen Edit-Eigenschaftssatz, der eine Gruppe von Bearbeitungseigenschaften beschreibt.
Diese Methode ist nicht implementiert.
Syntax
HRESULT SetEditPropertySet(
[in, out] long *pEditID,
[in] long State
);
Parameter
[in, out] pEditID
Zeiger auf eine lange ganze Zahl, die einen Bezeichner für den Edit-Eigenschaftssatz angibt oder empfängt.
[in] State
Gibt den Status des Edit-Eigenschaftssatzes an.
Wert | BESCHREIBUNG |
---|---|
ED_ACTIVE | Aktiviert den Edit-Eigenschaftssatz. |
ED_DELETE | Löscht den Edit-Eigenschaftssatz. |
ED_INACTIVE | Deaktiviert den Edit-Eigenschaftssatz. |
ED_REGISTER | Registriert den Edit-Eigenschaftssatz. |
Wenn der Wert ED_REGISTER ist, empfängt der pEditID-Parameter einen Bezeichner für den Edit-Eigenschaftssatz. Verwenden Sie für die anderen Flags den pEditID-Parameter , um den Bezeichner anzugeben.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Hinweise
Ein Bearbeitungsereignis ist ein Satz von Parametern, die eine Aufzeichnungssequenz definieren. Mit den Parametern können beispielsweise Bearbeitungsmodi, In- und Outpoints oder Suchpositionen angegeben werden. Jedes Bearbeitungsereignis besteht aus einem oder mehreren Parametern, die als Bearbeitungseigenschaften bezeichnet werden. Die Auflistung der Eigenschaften wird als Bearbeitungseigenschaftssatz bezeichnet. Jeder Bearbeitungseigenschaftssatz wird durch eine lange ganze Zahl identifiziert, die vom Gerätefilter zugewiesen wird.
Um ein Bearbeitungsereignis zu erstellen und auszuführen, muss die Anwendung die folgenden Schritte ausführen:
- Registrieren Sie einen Edit-Eigenschaftssatz. Rufen Sie die
SetEditPropertySet
-Methode mit dem Wert auf, der im State-Parameter ED_REGISTER. Wenn die Methode zurückgibt, enthält der pEditID-Parameter den Bezeichner für den Edit-Eigenschaftssatz. Verwenden Sie diese Nummer, um den Edit-Eigenschaftssatz in nachfolgenden Methodenaufrufen zu identifizieren. - Geben Sie die Bearbeitungseigenschaften mithilfe der IAMExtTransport::SetEditProperty-Methode an.
- Aktivieren Sie das Edit-Ereignis, indem Sie mit dem Wert ED_ACTIVE aufrufen
SetEditPropertySet
. - Rufen Sie den Transport
SetEditProperty
mit dem Wert ED_EDIT_SEEK auf. - Führen Sie das Filterdiagramm aus.
C++ |
---|
Registrieren Sie eine Edit-Eigenschaftssatz-ID. (Bewirkt, dass Arbeitsspeicher zugeordnet wird.) lange EditId; SetEditPropertySet(&EditId, ED_REGISTER); |
DV-Implementierung
MSDV unterstützt diese Methode nicht. Es wird E_NOTIMPL zurückgegeben.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | strmif.h (include Dshow.h) |
Bibliothek | Strmiids.lib |