Класс CDeferredCommand
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Отложенные команды помещаются в очередь с помощью вызовов методов в интерфейсе IQueueCommand и предоставляются диспетчером графов фильтров и некоторыми фильтрами. При успешном вызове одного из этих методов возвращается интерфейс IDeferredCommand , представляющий команду в очереди.
Объект CDeferredCommand представляет одну отложенную команду и предоставляет интерфейс IDeferredCommand , а также другие методы, разрешающие проверку времени и фактическое выполнение. Объект CDeferredCommand содержит ссылку на объект CCmdQueue , в котором он находится в очереди.
Счетчики ссылок управляют временем существования CDeferredCommand класса. При вызове функции-члена CDeferredCommand::Invoke вызывающее приложение получает указатель интерфейса, который подсчитывается по ссылке, а объект CCmdQueue также содержит счетчик ссылок на отложенную команду. Вызов функции-члена IDeferredCommand::Cancel выводит отложенную команду из очереди команд и тем самым уменьшает количество ссылок на единицу. После того как она была снята, команда не может быть возвращена в очередь.
| Защищенные члены данных | Описание |
|---|---|
| m_bStream | Пометка для времени потоковой передачи или времени презентации. значение , передаваемое в вызываемый метод. |
| m_Dispatch | Обращается к интерфейсу ITypeInfo . |
| m_dispidMethod | Метод для запускаемого интерфейса. |
| m_DispParams | Объект CDispParams, содержащий список параметров DISPPARAMS |
| m_hrResult | Сохраняет возвращенное значение HRESULT . |
| m_iid | Глобальный уникальный идентификатор (GUID) интерфейса. |
| m_pQueue | Указатель на объект CCmdQueue , предоставляющий интерфейс IQueueCommand . |
| m_pUnk | IUnknown — указатель на интерфейс, в котором будет выполняться команда. |
| m_pvarResult | Результирующие сведения, если таковые есть, из вызываемого метода. |
| m_time | Время выполнения команды. |
| m_wFlags | Флаги, указывающие контекст вызова. |
| Функции элементов | Описание |
| CDeferredCommand | Создает объект CDeferredCommand . |
| GetFlags | Извлекает флаги контекста, связанные с отложенной командой. |
| GetIID | Извлекает идентификатор интерфейса (IID) интерфейса, на котором будет выполняться метод. |
| GetMethod | Извлекает идентификатор диспетчеризации выполняемого метода. |
| GetParams | Извлекает список аргументов DISPPARAMS в метод . |
| GetResult | Извлекает результирующий список аргументов, если он существует. |
| GetTime | Извлекает время выполнения метода. |
| Invoke | Предоставляет доступ к методам и свойствам, предоставляемым объектом . |
| IsStreamTime | Указывает, должна ли команда выполняться во время потока или во время презентации. |
| Методы IDeferredCommand | Описание |
| Отменить | Отменяет ранее поставленный в очередь запрос CDeferredCommand::Invoke . |
| Достоверность | В настоящий момент не реализовано. |
| Отложить | Задает новое время презентации для ранее помещенной в очередь команды. |
| GetHResult | Извлекает значение HRESULT вызываемого метода. |