Класс CCmdQueue

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

Класс CCmdQueue является базовым классом, предоставляющим очередь объектов CDeferredCommand и функций-членов для добавления, удаления, проверка состояния и вызова команд в очереди. Объект CCmdQueue является частью объекта , реализующего методы IQueueCommand . Диспетчер графов фильтров реализует методы IQueueCommand , чтобы приложения могли помещать команды в граф фильтра. Фильтры, реализующие интерфейс IQueueCommand , используют этот класс напрямую. Если вы хотите использовать объекты CDeferredCommand , очередь должна быть производной от этого класса.

Существует два режима синхронизации: грубый и точный. В грубом режиме приложение ожидает прибытия указанного времени, а затем выполняет команду. В точном режиме приложение ожидает, пока не начнется обработка примера, который отображается в то время, а затем выполняет команду . Фильтр определяет, какой из них он будет реализовывать. Диспетчер графов фильтров всегда реализует грубый режим для команд, помещенных в очередь в диспетчере графов фильтров.

Если вам нужна грубая синхронизация, вероятно, потребуется подождать, пока не будет выполнена команда, а затем выполнить ее. Это можно сделать, вызвав CCmdQueue::GetDueCommand. Если вам нужно дождаться нескольких вещей, получите дескриптор события из CCmdQueue::GetDueHandle , а затем вызовите CCmdQueue::GetDueCommand при появлении сигнала об этом. Время потока будет переходить только между вызовами функций-членов CCmdQueue::Run и CCmdQueue::EndRun . Нет никакой гарантии, что если дескриптор задан, команда будет готова. При каждом сигнале о событии вызывайте функцию-член GetDueCommand (вероятно, с нулевым тайм-аутом); может возвращать E_ABORT, если команда не готова.

Если требуется точную синхронизацию, вызовите функцию-член CCmdQueue::GetCommandDueFor и передайте примеры, которые вы собираетесь обработать в качестве параметра. При этом возвращается следующее:

• Команда времени потока, которая должна быть выполнена в момент или до этого времени потока.
• Команда времени презентации, выполненная в момент или до представления времени потока. Это можно сделать только между функциями-членами CCmdQueue::Run и CCmdQueue::EndRun , так как вне этого сопоставление времени потока с временем представления неизвестно.
• Любая команда времени презентации должна быть выполнена сейчас.

Если требуется точную синхронизацию для примеров, которые могут обрабатываться в приостановленном режиме, необходимо использовать команды времени потока.

Во всех случаях команды остаются в очереди до вызова или отмены. Настройка и сброс дескриптора событий полностью управляются этим объектом очереди.

Защищенные члены данных	Описание
m_bRunning	Флаг для состояния выполнения; при выполнении установите значение TRUE .
m_dwAdvise	Сообщить идентификатор из эталонных часов (ноль, если нет необработанных рекомендаций).
m_evDue	Задает время выполнения каких-либо команд.
m_listPresentation	Хранит команды, помещенные в очередь во время презентации.
m_listStream	Хранит команды, помещенные в очередь во время потока.
m_Lock	Защищает доступ к спискам.
m_pClock	Текущие эталонные часы.
m_StreamTimeOffset	Содержит смещение времени потока, если m_bRunning имеет значение TRUE.
m_StreamTimeOffset	Содержит смещение времени потока, если m_bRunning имеет значение TRUE.
Функции элементов	Описание
CCmdQueue	Создает объект CCmdQueue .
CheckTime	Определяет, истекает ли заданное время.
GetDueHandle	Извлекает дескриптор события, который будет сигнализировать.
Переопределимые функции-члены	Описание
EndRun	Переключается в остановленный или приостановленный режим.
GetCommandDueFor	Извлекает отложенную команду, запланированную на указанное время.
GetDueCommand	Извлекает указатель на следующую команду, которая должна быть выполнена.
Вставить	Добавляет объект CDeferredCommand в очередь.
Новые функции	Инициализирует выполняемую команду и возвращает новый объект CDeferredCommand .
Удалить	Удаляет объект CDeferredCommand из очереди.
Выполнить	Переключается в режим выполнения.
SetSyncSource	Задает часы, используемые для синхронизации.
SetTimeAdvise	Настраивает событие таймера со ссылочными часами.