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


Метод IMemAllocatorCallbackTemp::GetFreeCount (strmif.h)

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

Метод GetFreeCount возвращает количество выборок свободных носителей. Это число равно общему количеству выборок носителей за вычетом количества выборок, которые в настоящее время хранятся фильтрами.

Синтаксис

HRESULT GetFreeCount(
  [out] LONG *plBuffersFree
);

Параметры

[out] plBuffersFree

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

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

Возвращает значение HRESULT . Ниже приведены возможные значения.

Код возврата Описание
E_POINTER
Аргумент указателя NULL
S_OK
Успешное завершение

Комментарии

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

Пока распределитель не будет зафиксирован, выборки не гарантированно будут выделены.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header strmif.h (включая Dshow.h)
Библиотека Strmiids.lib

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

Коды ошибок и успешности

Интерфейс IMemAllocatorCallbackTemp