CCmdQueue.New-Methode

[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 New -Methode initialisiert einen auszuführenden Befehl und gibt ein neues CDeferredCommand-Objekt zurück.

Syntax

virtual HRESULT New(
   CDeferredCommand **ppCmd,
   LPUNKNOWN        pUnk,
   REFTIME          time,
   GUID             *iid,
   long             dispidMethod,
   short            wFlags,
   long             cArgs,
   VARIANT          *pDispParams,
   VARIANT          *pvarResult,
   short            *puArgErr,
   BOOL             bStream
);

Parameter

ppCmd

Adresse eines Zeigers auf ein CDeferredCommand-Objekt , mit dem eine Anwendung den Befehl abbrechen, eine neue Präsentationszeit dafür festlegen oder Schätzungsinformationen abrufen kann.

Punk

Zeiger auf das Objekt, das den Befehl ausführen wird.

time

Zeit, zu der die Befehle in der Warteschlange ausgeführt werden sollen.

Iid

Zeiger auf den global eindeutigen Bezeichner (Globally Unique Identifier, GUID) der aufzurufenden Schnittstelle.

dispidMethod

-Methode für die -Schnittstelle, die aufgerufen werden soll.

wFlags

Flags, die den Kontext des Aufrufs beschreiben. Dieser Parameter unterstützt dieselben Flags wie die IDispatch::Invoke-Methode .

cArgs

Anzahl der übergebenen Argumente.

pDispParams

Zeiger auf die Liste der Variantentypen, die den Dispatchparametern zugeordnet sind.

pvarResult

Zeiger auf die Liste, in der ggf. Ergebnisse zurückgegeben werden sollen.

puArgErr

Zeiger auf den Index in der pDispParams-Parameterliste , in der der letzte Fehler aufgetreten ist.

bStream

Wert, der angibt, ob der Zeitparameter ein Streamzeitwert (TRUE) oder ein Präsentationszeitwert (FALSE) ist.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Gibt E_OUTOFMEMORY zurück, wenn ppCmd vom Erstellen des neuen CDeferredCommand-Objekts mit dem Wert NULL zurückgibt. Gibt andernfalls ein HRESULT zurück, das einen Fehler beim Versuch angibt, ein neues CDeferredCommand-Objekt zu erstellen. Wenn ein Fehler auftritt, wurde kein Objekt in die Warteschlange eingereiht.

Bemerkungen

Das neue CDeferredCommand-Objekt wird mit den Parametern initialisiert und der Warteschlange während der Erstellung hinzugefügt. Diese Methode ähnelt der IDispatch::Invoke-Methode .

Die Werte für den wFlags-Parameter umfassen Folgendes:

Anforderungen

Siehe auch

CCmdQueue-Klasse