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


Метод COutputQueue.QueueSample

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

Метод QueueSample помещает пример в очередь.

Синтаксис

void QueueSample(
   IMediaSample *pSample
);

Параметры

pSample

Указатель на интерфейс IMediaSample примера.

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

Этот метод не возвращает значение.

Комментарии

Этот метод добавляет образец в хвост очереди. Удерживайте критический раздел перед вызовом этого метода и вызывайте его только в том случае, если объект использует поток для доставки примеров. Чтобы определить, использует ли объект поток, вызовите метод COutputQueue::IsQueued .

Этот метод также можно использовать для добавления управляющих сообщений в очередь. Сообщение элемента управления — это определенная константа (приведение к типу LONG_PTR), которая указывает потоку выполнить определенное действие. Класс COutputQueue определяет управляющие сообщения, показанные в следующей таблице.

Метка Значение
Message Действие
EOS_PACKET Доставка уведомления об окончании потока.
NEW_SEGMENT Добавьте новый сегмент.
RESET_PACKET Сброс состояния очереди.
SEND_PACKET Отправка частичного пакета примеров.

Это защищенный метод, который класс COutputQueue использует для внутренних целей.

Требования

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

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

Класс COutputQueue