CCmdQueue.New-Methode

Artikel
07/28/2023

[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:

Wert	BESCHREIBUNG
DISPATCH_METHOD	Der Member wird als Methode ausgeführt. Wenn eine Eigenschaft denselben Namen hat, können sowohl dieser als auch das DISPATCH_PROPERTYGET-Flag festgelegt werden.
DISPATCH_PROPERTYGET	Der Member wird als Eigenschaft oder Datenmember abgerufen.
DISPATCH_PROPERTYPUT	Das Element wird als Eigenschaft oder Datenmember geändert.
DISPATCH_PROPERTYPUTREF	Das Element wird nicht über eine Wertzuweisung, sondern über eine Verweiszuweisung geändert. Dieser Wert ist nur gültig, wenn die Eigenschaft einen Verweis auf ein Objekt akzeptiert.

Anforderungen

Anforderung	Wert
Header	Winutil.h (Streams.h einschließen)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

CCmdQueue-Klasse

Freigeben über