Freigeben über


CMediaControl.Invoke-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.]

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.

Syntax

HRESULT Invoke(
   DISPID     dispidMember,
   REFIID     riid,
   LCID       lcid,
   WORD       wFlags,
   DISPPARAMS *pdispparams,
   VARIANT    *pvarResult,
   EXCEPINFO  *pexcepinfo,
   UINT       *puArgErr
);

Parameter

dispidMember

Bezeichner des Elements. Verwenden Sie CMediaControl::GetIDsOfNames oder die Dokumentation des Objekts, um den Versandbezeichner abzurufen.

riid

Für zukünftige Verwendung reserviert. Muss IID_NULL sein.

lcid

Gebietsschemakontext, in dem Argumente interpretiert werden sollen.

wFlags

Flags, die den Kontext des Aufrufs CMediaControl::Invoke beschreiben.

pdispparams

Zeiger auf eine Struktur, die ein Array von Argumenten, ein Array von Argument-Dispatch-IDs für benannte Argumente und die Anzahl der Elemente in den Arrays enthält.

pvarResult

Zeiger auf den Speicherort des Ergebnisses oder NULL , wenn der Aufrufer kein Ergebnis erwartet.

pexcepinfo

Zeiger auf eine Struktur, die Ausnahmeinformationen enthält.

puArgErr

Zeiger auf den Index des ersten Arguments innerhalb des rgvarg-Arrays der DISPPARAMS-Struktur, das einen Fehler aufweist. Weitere Informationen zu DISPPARAMS finden Sie im Platform SDK.

Rückgabewert

Gibt DISP_E_UNKNOWNINTERFACE zurück, wenn riid nicht IID_NULL ist. Gibt einen der Fehlercodes von CMediaControl::GetTypeInfo zurück, wenn der Aufruf fehlschlägt. Andernfalls wird das HRESULT aus dem Aufruf von IDispatch::Invoke zurückgegeben.

Anforderungen

Anforderung Wert
Header
Ctlutil.h (include Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CMediaControl-Klasse