CDeferredCommand-Klasse
[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.]
Verzögerte Befehle werden durch Aufrufe von Methoden auf der IQueueCommand-Schnittstelle in die Warteschlange gestellt und vom Filterdiagramm-Manager und von einigen Filtern verfügbar gemacht. Ein erfolgreicher Aufruf einer dieser Methoden gibt eine IDeferredCommand-Schnittstelle zurück, die den Befehl in der Warteschlange darstellt.
Ein CDeferredCommand -Objekt stellt einen einzelnen verzögerten Befehl dar und macht die IDeferredCommand-Schnittstelle sowie andere Methoden verfügbar, die Zeitüberprüfungen und die tatsächliche Ausführung ermöglichen. Ein CDeferredCommand -Objekt enthält einen Verweis auf das CCmdQueue-Objekt , für das es in die Warteschlange gestellt wird.
Die Referenzanzahl steuert die Lebensdauer der CDeferredCommand Klasse. Beim Aufrufen der CDeferredCommand::Invoke-Memberfunktion ruft die aufrufende Anwendung einen Schnittstellenzeiger ab, der verweisgezählt ist, und das CCmdQueue-Objekt enthält auch eine Verweisanzahl für den verzögerten Befehl. Durch Aufrufen der Memberfunktion IDeferredCommand::Cancel wird der verzögerte Befehl aus der Befehlswarteschlange entfernt und somit die Verweisanzahl um eins reduziert. Nachdem sie aus der Warteschlange genommen wurde, kann der Befehl nicht wieder in die Warteschlange eingefügt werden.
| Geschützte Datenmember | Beschreibung |
|---|---|
| m_bStream | Kennzeichnen sie für Streamzeit oder Präsentationszeit. an die aufgerufene Methode übergeben werden soll. |
| m_Dispatch | Greift auf die ITypeInfo-Schnittstelle zu. |
| m_dispidMethod | Methode für die auszuführende Schnittstelle. |
| m_DispParams | CDispParams-Objekt , das die DISPPARAMS-Parameterliste enthält |
| m_hrResult | Speichert den zurückgegebenen HRESULT-Wert . |
| m_iid | Globally Unique Identifier (GUID) der Schnittstelle. |
| m_pQueue | Zeiger auf das CCmdQueue-Objekt , das die IQueueCommand-Schnittstelle verfügbar macht. |
| m_pUnk | IUnknown-Zeiger auf die Schnittstelle, auf der der Befehl ausgeführt wird. |
| m_pvarResult | Daraus resultierende Informationen, falls vorhanden, von der aufgerufenen Methode. |
| m_time | Zeit, zu der der Befehl ausgeführt wird. |
| m_wFlags | Flags, die den Kontext des Aufrufs angeben. |
| Elementfunktionen | Beschreibung |
| CDeferredCommand | Erstellt ein CDeferredCommand-Objekt . |
| GetFlags | Ruft die Kontextflags ab, die dem verzögerten Befehl zugeordnet sind. |
| GetIID | Ruft den Schnittstellenbezeichner (Interface Identifier, IID) der Schnittstelle ab, auf der die Methode ausgeführt wird. |
| GetMethod | Ruft den Verteilerbezeichner der auszuführenden Methode ab. |
| GetParams | Ruft die DISPPARAMS-Argumentliste für die -Methode ab. |
| Getresult | Ruft die resultierende Argumentliste ab, sofern vorhanden. |
| GetTime | Ruft den Zeitpunkt ab, zu dem die -Methode ausgeführt wird. |
| Invoke | Ermöglicht den Zugriff auf Methoden und Eigenschaften, die von einem Objekt verfügbar gemacht werden. |
| IsStreamTime | Gibt an, ob der Befehl zur Stream- oder Präsentationszeit ausgeführt werden soll. |
| IDeferredCommand-Methoden | BESCHREIBUNG |
| Abbrechen | Bricht eine zuvor in die Warteschlange eingereihte CDeferredCommand::Invoke-Anforderung ab. |
| Confidence | Derzeit nicht implementiert. |
| Verschieben | Gibt eine neue Präsentationszeit für einen zuvor in die Warteschlange eingereihten Befehl an. |
| GetHResult | Ruft den HRESULT-Wert der aufgerufenen Methode ab. |