Freigeben über


IAMTimelineEffectable::GetEffect-Methode

[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.]

Hinweis

[Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden.]

 

Die GetEffect-Methode ruft den Effekt auf der angegebenen Prioritätsebene ab.

Syntax

HRESULT GetEffect(
  [out] IAMTimelineObj **ppFX,
        long           Which
);

Parameter

ppFX [out]

Empfängt die IAMTimelineObj-Schnittstelle des Effekts.

Welche

Prioritätsebene des abzurufenden Effekts.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Folgende Werte sind möglich:

Rückgabecode Beschreibung
S_FALSE
Keine Auswirkung bei der angegebenen Priorität,
S_OK
Erfolg.
E_POINTER
NULL-Zeigerargument.

 

Bemerkungen

Wenn die Methode S_OK zurückgibt, weist die von ihr zurückgegebene IAMTimelineObj-Schnittstelle eine ausstehende Verweisanzahl auf. Stellen Sie sicher, dass Sie die Schnittstelle freigeben, wenn Sie sie verwenden.

Hinweis

Die Headerdatei Qedit.h ist nicht mit Direct3D-Headern ab Version 7 kompatibel.

 

Hinweis

Um Qedit.h zu erhalten, laden Sie das Microsoft Windows SDK Update für Windows Vista und .NET Framework 3.0 herunter. Qedit.h ist im Microsoft Windows SDK für Windows 7 und .NET Framework 3.5 Service Pack 1 nicht verfügbar.

 

Anforderungen

Anforderung Wert
Header
Qedit.h
Bibliothek
Strmiids.lib

Siehe auch

IAMTimelineEffectable-Schnittstelle

Fehler- und Erfolgscodes