CCmdQueue.GetDueCommand-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.]

Die GetDueCommand -Methode ruft einen Zeiger auf den nächsten Befehl ab, der fällig ist.

Syntax

virtual HRESULT GetDueCommand(
   CDeferredCommand **ppCmd,
   long             msTimeout
);

Parameter

ppCmd

Adresse eines Zeigers auf den verzögerten Befehl.

msTimeout

Zeit, die vor dem Ausführen des Timeouts gewartet werden muss.

Rückgabewert

Gibt E_ABORT zurück, wenn ein Timeout auftritt. Gibt bei erfolgreicher Ausführung S_OK zurück. Gibt andernfalls einen Fehler zurück. Gibt ein Objekt zurück, das mithilfe von IUnknown::AddRef erhöht wurde.

Bemerkungen

Diese Memberfunktion blockiert, bis ein ausstehender Befehl fällig ist. Die Memberfunktion blöcke für die Zeit in Millisekunden, die im msTimeout-Parameter angegeben ist. Streamzeitbefehle werden nur zwischen den Memberfunktionen CCmdQueue::Run und CCmdQueue::EndRun fällig. Der Befehl bleibt in der Warteschlange, bis er ausgeführt oder abgebrochen wird.

Anforderungen

Siehe auch

CCmdQueue-Klasse