CMediaControl.Invoke-Methode

Artikel
07/28/2023

[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

Freigeben über