Поделиться через


Метод CCmdQueue.GetDueCommand

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Метод GetDueCommand извлекает указатель на следующую команду, которая должна быть выполнена.

Синтаксис

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

Параметры

ppCmd

Адрес указателя на отложенную команду.

msTimeout

Время ожидания перед выполнением тайм-аута.

Возвращаемое значение

Возвращает E_ABORT, если истекло время ожидания. В случае успешного выполнения возвращает S_OK; в противном случае возвращает ошибку. Возвращает объект, который был увеличен с помощью IUnknown::AddRef.

Комментарии

Эта функция-член блокируется до тех пор, пока не будет выполнена ожидающая команда. Функция-член блокирует время в миллисекундах, указанное в параметре msTimeout . Команды времени потока выполняются только между функциями-членами CCmdQueue::Run и CCmdQueue::EndRun . Команда остается в очереди до выполнения или отмены.

Требования

Требование Значение
Заголовок
Winutil.h (включая Streams.h)
Библиотека
Strmbase.lib (розничные сборки);
Strmbasd.lib (отладочные сборки)

См. также раздел

Класс CCmdQueue